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I 



The COSMAC Development System CDP18S005 is a 
prototyping aid for the design of hardware and software systems 
based on the RCA CDP1802 microprocessor. The COSMAC 
Development System is specially structured to provide a testbed 
in which hardware/software prototypes of systems containing a 
microprocessor may be designed, built, and tested. In small- 
volume applications it can be used as the major building block 
for dedicated microcomputers. 

This Manual is designed as a guide for the COSMAC 
Development System user. It includes a detailed description of 
each of the available hardware modules as well as a complete 
explanation of the functions available from the software sup¬ 
plied with the system. 

The COSMAC Development System (CDS) consists of a card 
nest with self-contained power supply, an easy-to-use control 
panel, and a basic set of plug-in modules. It is packaged to 
promote easy interfacing with external devices. These interfaces 
may be custom-designed by the user or, in the case of common 
peripheral devices, are available from RCA as standard op¬ 
tional modules, and include a floppy disk interface. 

The COSMAC Resident Software Package (which runs on 
the CDS in a stand-alone manner) provides a means for rapid 
coding and debugging of COSMAC programs. Many of its 
features are compatible with those of the COSMAC Software 
Development Package (CSDP) timesharing program- 
development aids. Additional software and firmware packages 
are available from RCA including packages for floppy disk 
hardware and multiple precision arithmetic. 


i 
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Operating and 
Programming the CDS 

System Overview 


The CDP18S005 COSMAC Development System 
(CDS) consists of a power supply, control panel, and 
a set of connectors for printed circuit boards. Many of 
the 25 available positions are occupied by specific 
module types. A printed circuit backplane distributes 
common signal lines to all connector positions. There 
are a small number of additional wire-wrapped 
connections. The unassigned connectors are available 
for user expansion of memory and I/O function. 

Supplied modules include the CDP1802 CPU 
module, an address latch and memory bank select 
module, a 4-kilobyte RAM module, a ROM/RAM 
module containing the Utility program, an I/O 
decode module, terminal interface module, and a 
control module. The position assignments of these 
modules are given in Table III in the next Section. All 
logic functions are implemented in CMOS operating 
at + 5 V. 

The control panel provides a simple user interface. 
Depressing the RESET switch initializes the system. 
Depressing the RUNU switch starts the utility 
program, identified as UT20. Depressing RUNP, on 
the other hand, will start program execution from 
memory location 0, the normal starting location of a 
user program. A STEP/CONTINUOUS switch 
allows stepping one machine cycle with each 
depression of RUNU or RUNP. A 4-digit display on 
the front panel shows the current address and a 2- 
digit display shows the value of the data bus or, by 
switch selection, the last I/O data byte. Five ad¬ 
ditional LED indicators monitor the State Code, 
WAIT, CLEAR, and Q lines of the CPU while a 
sixth LED indicates when the machine is running. 
This RUN indicator will be ON whenever the CPU is 
running and not in the IDLE mode. The LOAD 
switch is used to place the CPU in the ‘load mode’ in 
which the DMA channel can be used to load RAM. 


See The User Manual for the CDP1802 COSMAC 
Microprocessor, MPM-201, for a detailed 
discussion of this mode. The LOAD switch is sup¬ 
plied as a convenience for the user designing his own 
system interfaces and is not used in normal CDS 
operations. The supplied programs are loaded using 
the Monitor program as discussed in the next section. 

The CDS'is designed to work with any one of the 
following terminals: 

1) An ASR 33 Teletype ^ terminal (or its 
electrical equivalent) which should include a 
remote reader control circuit to permit the CDS 
to control the paper tape reader. 

2) A TI “Silent 700” terminal^. Model 733 
ASR with tape cassettes and “Remote Device 
Control ’ ’ option. This terminal uses dual 
program-controlled magnetic tape cartridges as 
storage medium and prints at 30 characters per 
seconds. 

3) Any terminal conforming to the EIA 
RS232C standard interface and having a baud 
rate of 110, 300, or 1200. 

The CDS is designed to automatically adjust to a 
variety of data terminal speeds and will accommodate 
either full- or half-duplex operation. 

Included with the CDS are an assembler and editor 
program for software development. Loading in¬ 
structions for these programs are given in the next 
subsection. Details on operation of the Assembler and 
Editor are given later in this manual. If a Floppy 
Disk system is used with the CDS, refer to the Floppy 
Disk Manual for operation of the Assembler, Editor, 
and other programs. 

^ Registered Trademark, Teletype Corporation, 

^ Registered Trademark, Texas Instruments Corporation. 
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Initial Operation 


Li II-C 


CDS Hookups 


Two I/O data terminal cables are supplied with the 
Development System - one for terminals using a 20- 
mA l6op interface, the other for an EIA RS232C data 
terminal. Each cable with its terminal board con¬ 
nection is labeled. To connect the data terminal, 
select the proper cable and plug its receptacle labeled 
“pi” into the appropriate connector mounted directly 
on the accessible end of the terminal board, as shown 
in Fig. 1. For a list of terminal interface cables and 
their functions, refer to Appendix J. 


MOUNTED I/O 
TYPEWRITER 
CONNECTORS 


25-PlN DELTA 


MATING EIA 
CONNECTOR 



Fig. 1 — Cable connection for I/O data terminals. 


The two connectors on the terminal board are 
labeled appropriately. The connector on the other end 
of the cable plugs into the terminal. For a Teletype 
terminal, remove its cover and plug the cable into 
connector position 2 (J2) in the array of white plastic 
Molex connectors located in the back of the unit. For 
an EIA terminal, plug the EIA connector on the cable 
into the receptacle on the back of the data terminal. 
Fig. 1 shows these connections. 

When the Silent 700 terminal is used, the cable 
supplied with that device should be connected to the 
CDS via the EIA cable. 

J^ut the terminal in the Line mode, select the ap¬ 
propriate baud rate and set for full-duplex operation 
before attempting to use any terminal. 

Appendix B gives instructions for converting a 
TTY from half- to full-duplex operation. The in¬ 
terface is a 20-mA current loop. Make necessary 
changes per Appendix B to convert a TTY to 20-mA 
operation. If a TTY is to be used with the assembler 
program, the remote reader control circuit should be 
installed in accordance with the instructions in 
Appendix C. Once installed, its switch should be set 
in the MANUAL position before continuing. 


Install the power cable and switch power on. Press 
RESET followed by RUNU. This sequence will 
cause the RUN light to go ON and the system is now 
operating with UT20 in control. 

This program begins by reading the first keyboard 
input character to define for itself the terminal 
character rate and whether it should “echo” typed 
information to the data terminal printer. If the 
terminal is operating in the full-duplex mode, the user 
should begin by pressing the RETURN key on the 
keyboard. For the half-duplex mode, the user should 
press the LINE FEED key instead. The system then 
responds with the prompt character (*). It now 
“knows” the essential characteristics of the I/O data 
terminal. Reaching this stage verifies that most of the 
hardware is operating properly. 

CDS Checkout Program 

Even with little or no knowledge of the COSMAC 
command repertoire, the user can further verify 
proper system operation by loading, from the ter¬ 
minal, an elementary test program. For example, a 
simple time-out loop can be run in which the RUN 
light goes off after a specific elapsed time from the 
initiation of execution. 

Each line of user keyboard input is terminated by a 
depression of the RETURN key on the keyboard 
The test time-out program can be loaded into memory 
by typing in 

!M0AF8FFB1219191913A0300(CR) 

The system will reply with the prompt character. One 
can verify proper loading by entering 

?M0AA(CR) 

The system will print the characters just entered 
(after the memory location addressed, “0000” in this 
case) and will return the prompt character again. The 
time-out program can then be run either by entering 

SPO(CR) 

or by depressing RESET followed by RUN. In either 
case, the RUN indicator should go off after ap¬ 
proximately 2.6 seconds. This step establishes that 
the read-write memory (RAM) is operational. 


• In this Manual, (CR) at the end of an example of a user keybourd 
input denotes the terminating carriage RETURN- Spaces in an 
input hne will be denoted by blanks in the example addi¬ 

tional emphasis, by the symbol A 
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Loading and 
Outputting Programs 

Programs may be entered manually by use of the 
! M command, just described. This and other 
Monitor commands are covered in detail in the next 
section. Ordinarily, programs will be loaded from 
paper tape via a TTY, from magnetic tape cassettes 
via the TI terminal, or from a floppy diskette via the 
Floppy Disk system. The latter is covered separately 
if) the RCA COSMAC Floppy Disk System CD- 
P1BS805 Instruction Manual MPM-217. RCA- 
supplied CDS programs are designed to work in the 
full-duplex mode. 

Following are the methods used with paper tape 
and magnetic cartridges; 

Paper Tape Systems 

To load a paper tape: 

1 ) Press RESET, followed by RUN U. 

2) Press the RETURN key (CR) on the TTY. 
Make sure it is in the LINE Mode and the 
installed switch is in the MANUAL position. 

3) UT20 will return the symbol * indicating it 
is ready to accept commands. 

4) Position the tape in the header and turn on 
the tape recorder. 

5) When loading is complete, UT20 will issue 
another *. 

6) Start the program by typing $U0(CR). 

If preferred, typing can be suppressed during 
paper-tape loading by pressing the LINE FEED key 
instead of CR at step 2. In this case, the user should 
re-initialize the system after loading by pressing 
RESET, RUN U, and CR before attempting to start 
the loaded program. 

UT20 monitors the program being loaded and will 
issue a ? if a format error is detected. If an error is 
detected, stop and reload the tape from the begin¬ 
ning. 

To punch reloadable tape: 

1) With the TTY in the LOCAL mode, 
position tape in the punch, turn the punch 
ON, and make a header of nulls (control-shift- 

P). 


2 ) Type IMaaaa A where aaaa is the hex 
address of where the data is to be reloaded 
(normally location 0000). 

> 3) Turn the punch OFF and put the TTY in 
the LINE mode. 

4) Initialize the CDS with a RESET, RUNU, 
followed by a RETURN (CR). 

5) Next, type ?Maaaa Acount, where the 
address is the starting address of data to be 
read from memory, and count is the number of 
hex bytes to be punched. 

6) Turn the punch ON and press CR. After the 
tape is punched, some more nulls should be 
added to its end. 

The assembler and editor programs 
automatically punch reloadable tape as described in 
the Section titled CDS Resident Software 
Development Aids. 


Magnetic Tape Systems 


To load a magnetic tape: 

1) Press RESET, RUN U, then CR. 

2) UT20 will retiun the symbol *. 

3) Mount the cassette. Rewind it and press 
LOAD/FF to advance to the first record. 
Make sure the drive is in the LINE and 
PLAYBACK mode. 


4) When loading is completed, UT20 will issue 
another *. Start the program by typing 
$U0(CR). 


Typing during load can be suppressed by turning 
the printer OFF. If a ? is typed during loading, an 
error has been detected and the tape should be 
reloaded. 


To record reloadable tape; 

I) With the terminal in the LOCAL and 
RECORD mode, mount a blank cartridge. 


2) Type IMaaaa A where aaaa is the hex 
address of where data is to be reloaded 
(normally location 0000). 


3) Switch to the LINE PLAYBACK 
mode and initialize the CDS with a , 

RUN U, and CR. 
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4) Type ?Maaaa Acount, where the address is 
the starting address of the data to be read from 
memory and count is the number of hex bytes 
to be recorded. 


5) Turn the Record Control switch ON and 
press CR. After the data has been output, 
UT20 will issue another *. 

For another system checkout program using the 
supplied “Deduce” game, refer to Appendix H. 


Introduction to the 
Monitor Software 
UT20 


Utility Commands 

The CDP18S005 COSMAC Development System 
includes a Monitor program, known as UT20, which 
performs commonly required functions of running the 
terminal interface, providing a means of reading and 
generating reloadable tape, giving, access to all 
memory locations, and allows the user to start 
program at a given location. The following explains in 
detail the ?M and !M commands already mentioned, 
plus others not yet discussed. 

In general, after the system has been RESET, the 
user has two choices: pressing RUN begins execution 
of his program at location 0000, while pressing RUN 
U begins execution of UT20 (at 8000). After pressing 
RUN U, the user next presses either a LF (line feed) 
or a CR (carriage return) key, depending upon his 
installation. A CR initiates FULL DUPLEX 
operation, an LF, HALF DUPLEX. Besides 
establishing the need to echo, UT20 uses this input to 
calculate the timing parameters necessary to run the 
terminal. Thus, a single program can operate with 
wide variations in clock speed or terminal speed. 

When UT20 is ready to accept a command, it types 
out an asterisk (*) as a prompt character. 

?M Commands 

To interrogate memory, type a command such 
as 

?M2F5 3(CR) 

UT20 responds by printing out the contents of 
memory beginning at location 02F5: three bytes are 
printed out as two hex digits each. Each line of output 
begins with the address, and data is grouped in 2-byte 
(4-digit) blocks. When necessary, new lines are begun 


every 16 bytes, with the previous lines ending in 
semicolons. The user may enter any number of digits 
to specify the beginning location (leading zeroes are 
implied, if necessary). If more than four digits are 
entered, only the last four are used. The number of 
bytes to be typed out should be in hex. Again, if more 
than four digits are entered, only the last four are 
used. This feature allows the correction of a mistake 
simply by continuing the type and terminating the 
typed sequence with the correct 4-digit values (230024 
is, effectively, 0024). If the number of bytes to be 
typed is not specified, one byte is assumed. For 
example: 

?M2F5(CR) 

would result in the typeout of the one byte at location 
02F5. 

When the user wants to punch a reloadable 
paper tape, he requests a memory type-out as 
previously described. 


!M Commands 

In general, data is entered into memory, by 
means of a command such as 

!M12F 434F534D4143(CR) 

This command enters six bytes (two hex digits 
each) into memory beginning at location 012F. Once 
again, the starting location is determined by the last 
four digits entered. Data is entered into memory after 
each two hex digits are typed. If the user types an odd 
number of digits, the last digit is ignored, and the 
error message (‘?’) is typed out. It is therefore only 
necessary to re-enter the last byte. 
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The !M command provides two options that 
facilitate memory loading. First, a string of data can 
be extended from line to line by typing in a comma 
just before the normal CR. (In this case press the CR- 
LF (carriage return-line feed) keys before beginning a 
new line.) For example, 

!M23 56789ABC,(CR)(LF) 
DEF0123456,(CR)(LF) 

3047(CR) 

enters 11 successive bytes beginning at location 0023. 
Between successive hex pairs while data is being 
entered, any non-hex character except the comma 
. land semicolon, as will be discussed) is ignored. This 
arrangement permits arbitrary LF’s, spaces (for 
readability), nulls (generated by the utility program 
or by a time-share system to give the carriage time to 
return), etc. 

As a second optional form of data entry, a 
string of input data can be terminated by a semicolon 
(and a CR). The utility program then expects more 
data to follow on the next line, but preceded by a new 
beginning address. The line must have the format of 
an !M command, but with the !M omitted. This 
option provides the mechanism for reading in a paper 
tape previously ptmched out as a result of the ?M 
command. (Recall the format of multiline ?M out¬ 
puts discussed above.) 

The utility program ignores all non-hex 
characters following !M, allowing CR, LF, and nulls 
to be inserted in the tape without disturbing the !M 
command. The semicolon feature allows non¬ 
contiguous memory areas to be loaded. 

$U Commands 

The #U command is used to start program 
execution. For example, 

$U6C(CR) 

starts program execution at location 006C with 
P —X=0. This command will leave the terminal 
interface and floppy disk interface (if installed) ac¬ 
tive. Consequently, the user program should not use 
I/O commands associated with these interfaces. For a 
further discussion of the terminal interface and the 
floppy disk interface, see the material on Module 
Description and Signal Mnemonics in the next 
Section. For further details on the $U command, refer 
to “Two-Level I/O” under Input/Outpul Inter¬ 
facing in the next Section. 

If only $U(CR) is typed with no address 
specified, execution will start at location 0000. If 
more than 4 address digits are typed, only the last 4 
will be used. 


$P Commands 

The $P command is similar to the $U command. 
For example; 

$P6C(CR) 

would also start program execution at location 006C 
with P = X=0 except, in this case, the terminal and 
floppy disk interfaces may be disabled. This feature is 
a convenience for the user so that his program can use 
I/O commands normally associated with these 
peripherals. 

If no address is specified, program execution 
starts from location 0000. The function is equivalent 
to pushing the RESET then RUN P buttons on the 
control panel. This command also obeys the 4ast-4- 
digits’ address rule. 

For further details of this command, refer to 
“Two-Level I/O” under Input/Output Interfacing 
in the next Section. 

$L Commands 

The $L command is used in systems having a 
floppy disk. Typing 

*L 

causes UT20 to type 
READ? 

asking for the unit and track number of the diskette 
file to be loaded. For a discussion of the disk loader 
program, refer to the RCA COSMAC Floppy Disk 
System 11 CDP18S805 Instruction Manual MPM- 
217. If a floppy disk system is not installed and this 
command is accidentally activated, simply do a CR 
after the READ? interrogation, UT20 will type 

DRIVE NOT ON 

and issue an *, waiting for another command. 

?R Commands 

When UT20 is activated (via RESET, RUN U|, 
one of the first things it does is save 13-1/2 of the 16 
‘R' registers of the CPU in its RAM stack located at 
address 8C00 for 32 bytes. Registers RO, Rl, and 
R4.1 are altered, but the states of the remaining 
registers are preserved at the time when UT2.0 was 
activated. This feature provides a means of 
examining most CPU registers for debugging pur¬ 
poses. 
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The ?R command provides for automatic readback 
of the stored register states with X’s for registers RO, 
Rl, and R4.1 to indicate that they have not been 
preserved. For example, RESET, RUN U, CR then 
?R gives this format: 


XXXX XXXX 18D4 3821, XX33 B760 8A15 0017 

t ■. t 

RO ' R7 

5518, 0717 34AA 8197, A401 6789 A825 01B9 

t.-- t 

R8 RF 


NOTE: the ?R must be the first command given to 
UT20 after it is started, because UT20 uses the stack 
itself when other commands are issued. Thus, it may 
overwrite the preserved registers when executing any 
command other than ?R, 

Summary of UT20 
Operating Instructions 

In summary, after receiving the prompt 
character the user may type 

?M(address) A (optional count) (CR) 

!M(address) A(data) (Optional, or ;) (CR) 

(where the data may have non-hex digits between 
each hex pair) 

SP (optional address) (CR) 

$U (optional address) (CR) 

$L 

?R(CR) 

UT20 ignores initial characters until it detects ?, !, or 
$. Then inputs which are not compatible with the 
above formats cause an error message (?). 

A further detailed summary of these basic 
operating instructions is given below, repeating the 
information just given in a more concise form. 

1. After pressing “RUN U”, the user should press 
CR (for full-duplex operation). This instruction 
sets up the bit-serial timing and specifies echo or 
not. 

2. UT20 will return * as a prompt. 

3. Following *, UT20 ignores all characters until 
one of or ! is typed in. 


4. Following ?M or !M, UT20 waits for a hex 
character. It then assembles an address. If more 
than four hex digits are typed, only the last four are 
used. Next, a space is required. Note: A denotes a 
space.' 

a. For ?M addr A a hex count may follow (again, 
only the last four digits are kept), and the 
command is terminated by CR. If no count is 
entered, one byte will be typed. 

b. For !M addr A data must follow. An even 
number of hex digits is required. Before each hex 
pair arbitrary filler, except for a CR, comma, or 
semicolon, is allowed. CR terminates the 
command, unless it is immediately preceded by a 
comma or, as is generally the case, by a 
semicolon. 

i. In case of comma CR the user must insert 
an LF for UT20 to continue to accept data. 
This procedure is a form of line continuation. 

ii. In case of a semicolon all following 
characters are ignored until the CR is typed. 
Then, the user must again provide an LF, and 
UT20 continues as if it had received optional 
filler, then a starting address, then a space, 
and then data. 

iii. The !M command can be followed by as 
many continuation lines as needed, mixed 
between the two types if desired, and is finally 
terminated with a CR not preceded by a 
comma or semicolon. 

5. Commands $F or $U may be followed by a 
starting address. The last 4 digits are used if more 
than 4 are typed in. If no address is given, 0 is 
assumed. Program execution begins at the specified 
location with RO as the program counter • . The $P 
command disables the terminal and floppy disk 
interfaces whereas SU does not. 

6. Command SL starts the floppy disk loader 
program which will issue the prompt 

READ? 

A proper response is a 4-digit number 
requesting unit and track mnnber, followed by a 
CR. If an error is detected during the read 
operation, a diagnostic message is printed. 

7. Command ?R causes a readout of the 16 R 
registers saved when UT20 is initialized. X’s are 
written for those registers not preserved. 

® $P and $U always begin with RO as program counter. This 
arrangement is consistent with the fact that P=0 and X^O 
after the CPU is RESET. Refer to the CDP1802 data sheet 
for other actions of RESET. 
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8. When a !M, ?M or ?R command is accepted 
and completed, UT20 types another * prompt. 

9. When UT20 detects bad syntax, it types out a ? 
and returns the carriage. If a mistake is made when 
data is entered (by typing in an odd number of 
digits), all data will have been entered except the 
last hex digit. Note that the “only-last-four-digits” 
rule in the address field allows the user to correct an 
address error without retyping the whole com¬ 
mand. For example, a mistaken 234 can be 
corrected by continuing. Thus, 2340235 is, ef¬ 
fectively, 0235. A bad command can be aborted by 
typing in any illegal character except after !M or 

“?M or between input hex data pairs. In these cases, 
the user should type any digit and then, for 
example, a period. 


Terminal Interfacing 


Hence, the total number of Ts in the eight intelligence 
bits is always an even number. Some data terminals 
may be set up to generate either even or odd parity. 
UT20 ignores the parity bit, so either even or odd 
parity is acceptable. 

Data from the CDS is generated with the same 
format; i.e., a start bit, 7 data bits, a parity bit, and 
two stop bits. Note that the CDS does not generate 
parity - the parity bit is always a ‘T regardless of the 
data bits. Therefore, terminals interfacing to the CDS 
should ignore the parity bit. 

UT20 Read and Type Routines 

The UT20 read and type routines provide the 
basic software mechanism for communication be¬ 
tween the CDS and data terminal. Several different 
routines are available to facilitate different types of 
I/O data transfers. 


ASCII Coding 

The CDS is designed to interface to a data 
terminal via a serial ASCII code using either a 20-mA 
current loop or an EIA RS232C standard electrical 
interface. When a key is struck on a TTY terminal, 
tile information denoting that character is converted 
to its ASCII code and appears On the output ter¬ 
minals as a serial data-bit stream. The serial data 
originating at the TTY for the letter ‘M’ is shown in 
Fig. 2. The character is framed by a start bit B and 


LOGIC I * 


1* 

1* 

1*1* 

1*1 

* 

1 * 

1* 

1 -M- 1 -tt 

1 

tt 









n 

' 

2 

3 4 

5 

6 

7 

8 



D 1 

D 1 

D 1 D 1 

D 1 

D 1 

1 ^ 

P 

F 1 F 



_ ACTUAL 








DATA BITS 







INTELLIGENCE 

BITS 




^- 7 DATA BITS 







PLUS 1 PARITY BIT 





COMPLETE CHARACTER 
"M" (4D|6) 


* = ONE BIT TIME P = PARITY BIT 
B = START BIT D = DATA BIT 

F=ST0P BIT -=ASYNCHR0N0US TIME 

BETWEEN CHARACTERS 


92CS-28I00 

Fig. 2 — Data terminal bit serial output for the 
character "M'\ 


two stop bits FF. By convention two stop bits are 
used for data transmission at 10 characters per second 
although 1, 114, or 2 are also acceptable outputs from 
various different terminals. A parity bit P is also 
shown. For even parity, the parity bit would be a T’ 
only if the 7 data bits contain an odd number of ‘Ts. 


These routines are designed to allow adoption to 
various terminal speeds arid to determine whether or 
not characters read in should be “echoed” (ie., typed 
back immediately). For these purposes, a ‘sub¬ 
subroutine’ called DELAY is included which 
provides the necessary bit timing delays to the read 
and type routines. DELAY uses RC as its program 
counter, which must be set-up to point to location 
80EF. UT20 does this automatically when it is 
started. Any user program using a read or type 
routine must not alter RC, or must restore it to 80EF 
before calling a read or type routine. Also, the upper 
half of register RE (RE.I) contains a control con¬ 
stant. The least significant bit specifies echo (0 
denotes echo, 1 denotes no echo). For full-duplex 
operation, then, this bit is a zero. Again, this is 
automatically set when UT20 is started and the CR or 
LF characters received. 

The remainder of RE.I constitutes a timing 
parameter (TP). TP is calculated as follows: 


TP = 2x 


interval between two serial bits 


320 X (CPU clock period) 




where the fraction is rounded to the nearest integer. 
For example, because a Teletype Model 33 operates 
at 10 characters per second and 11 bits per character, 
for the CDS running from the supplied 2.0-MHz 
clock. 


*The factor of 2 comes from the fact that the input serial wave¬ 
form is sampled over two successive bit times. The factor of 320 
comes from the fact that the time between samples is 20 instruc¬ 
tion times, with each instruction taking 16 clock periods. 
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TP = 2 X 


1 s 1 char 
10 char 11 bits 


320 X 


1 s 

2.0 X 10^ 


= 2 X 56.8 (rounded to 57) 

= 114|o = 72i6 


RE. 1 is reserved for the operating constant 
(control constant 0 or 1 added to the timing parameter 
TP) discussed above. 

One byte of RAM is needed by read and type 
routines. These routines assume that R2 points to free 
RAM and M(R(2)) is altered by them. In general, the 
user can set R2 to any free RAM location. UT20 uses 
a byte in its dedicated RAM for this purpose. 


Because for proper operation TP must be less 
thari 255, there is a bound on the speed of terminals 
si^pported at any given clock rate. Faster terminals or 
sibwer clocks can be supported to the extent that 
roundoff errors do not cause bad timing. For 
example, at 2.0 MHz and 30 10-bit characters per 
second, 


TP = 2x 


J_ 

30 ^ 10 

320/2.0 X 10^ 


= 2(20.8) = 42io = 2Ai6 


and the round-off error is small (2100 instead of 20.8). 
On the other hand, at 2.0 MHz with baud rates above 
1200, the round-off error would be too high. 


The utility program UT20 uses a subroutine 
“TIMALC” to generate the operating time constant, 
using the first character typed in by a user. This 
routine times the intervals between incoming bits to 
calculate TP and reads one bit to determine whether 
or not to echo. Specifically, if a CR is entered while 
TIMALC is running, then echoes will be provided; 
an LF suppresses echoes. In either case, RE.l is 
loaded with the appropriate constant. TIMALC also 
loads the subroutine pointer for the DELAY routine. 
The user of TYPE and READ has the option of 
calling TIMALC or setting up RE.l and the pointer 
to the DELAY routine himself. As a convenience to 
the user, UT20 leaves RE.l and RC properly ad¬ 
justed while performing a $P or $U operation and 
may be used unless they have been altered by the 
user. 


All read and type routines and TIMALC use R3 
as their program counter, and return to the caller 
with SEP R5. They can be called directly from a 
program that can use R5 as its program counter, or 
they may be called through the Standard Call and 
Return Technique (SCRT) described in the User 
Manual for the CDP1802 COSMAC 
Microprocessor, MPM-201 in the Section 
Programming T echniques under ‘ ‘ Subroutine 
Techniques”. This programming technique is the 
most general and is recommended. 


RF.l is used in certain cases to pass the byte 
being read or typed between the calling routine and 
these subroutines. When READ is exited, it leaves 
the input byte in RF.l. When TYPE is entered at 
location 81A4, the byte to be typed is taken from 
RF.l. 

All routines alter RE.O and RF.O. They also alter 
D, DF, and X. The READ routine leaves the input 
byte in D as well as in RF.l, but the byte in D will be 
destroyed if the Standard Call and Retirrn Technique 
is used. 


When TIMALC exits, R3.1 is left holding A.l 
(READ) = A.l (TYPE) = 81, but R3.0 is 
meaningless. When READ exits, R3 is ready for 
entry at RE ADAH (see Table II). When TYPE exits, 
R3 is ready for entry at TYPE5 (see same table). 
When DELAY exits, RC is ready for another call to 
DELAY. When the Standard Call and Return 
Technique is used, R3 is automatically set up. 

The READ routine has two entry points - READ 
and RE AD AH. The former acts as described above 
and has no other side-effects. The latter operates just 
as READ does, but with the following side-effect. If 
the character read in is a hex character (0-9, A-F) 
then the 16-bit contents of RD are shifted four bits to 
the left, and the 4-bit hex equivalent of the input 
character is entered at the right. DF is then set to 1 on 
exiting. If the input character is not a hex character, 
RD is not affected, but DF is set to 0 on exiting. 


CAUTION: A READ may immediately be followed 
by another READ, but not immediately by a TYPE. 
The caller should wait 1.5 bit times first, which he 
can do by entering TYPE at TYPE5D or by calling 
DELAY, with a parameter of 7 or greater. 

The DELAY subroutine assumes that the calling 
program counter is R3. It uses the value, n, of the 
immediate byte at M(R3) to generate a delay equal to 

(20 + m (2n + 6)) instruction times 

where m is time constant in RE.l (see previous 
discussion). It then increments R3 past the calling 
parameter and returns via a SEP R3. 
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The TYPE routine has five different entry 
points. Three of them simply specify different places 
to fetch the character from; TYPE types from RF.l, 
TYPE5 types from M(R5) and increments R5, and 
TYPE6 types from M(R6) and increments R6. 
TYPE5D is an entry which provides a 1.5-bit delay 
before going to TYPES. The purpose of this delay is 
to let an immediately preceding echoed READ 
process to completion before typing. TYPE2 is an 
entry which results in RF.l being typed out in hex 
form as two hex digits. Each 4-bit half is converted to 
a ASCII hex digit (0-9, A-F) and separately typed 
out. 

Notice that the READ routines are designed to 
facilitate repeated calls on RE AD AH, while the 
TYPE routines are designed for repeated calls to 
TYPES. In order to output a string of variable data 
characters following a READ, given the timing 
restriction mentioned earlier, it is most logical to call 
TYPESD first, using an immediate “punctuation’’ 


byte (i.e., non-data such as space, null, etc.) to get the 
required initial delay and to follow either with 
repeated calls on TYPE (with the output variable 
data characters picked up from RF.l) or repeated 
calls on TYPES using immediate data characters. 
This procedure permits a maximum output character 
rate. 

Another routine, OSTRNG, can be used to 
output a string of characters. OSTRNG picks up the 
character string pointed to by R6 and tests each 
character for zero. The characters should be already 
encoded in ASCII. If a zero is found (ASCII ‘null’), 
the program terminates and returns control to the 
user via a SEP R5. If the character is not a zero, it is 
typed out to the terminal. The OSTRNG routine 
includes a delay on the front end so that it may be 
called at any time - even following a read. 

Tables I and II summarize the functions and 
calling sequences just described. 


Register 

Name 

Register 

Number 

PTER 

RO ] 

CL 

R1 J 

ST 

R2 

SUB 

R3 

PC 

R5 

DELAY 

RC 

ASL 

RD 

AUX 

RE 

CHAR 

RF 


TABLE 1 - UT20 REGISTER UTILIZATION 
Function and Comments 

Altered by UT20 while storing registers. R4.1 is similarly altered. 

Pointer to RAM "'work” byte. UT20 uses R2 = 8C00. 

Program counter for all routines except DELAY. 

Program counter for UT20 which calls the routines above. 

Program counter for the DELAY routine. Points to DELAY1 in memory. 

Assembled into by READAH (input hex digits). 

RE.1 holds time constant and echo bit. 

RE. O is used by all READ and TYPE routines and by TIMALC, OSTRNG, and CKHEX. 

RF. l holds input/output ASCII character. 

RF.O is used by all READ and TYPE routines and by TIMALC, OSTRNG, and CKHEX. 


TABLE II ^ UT20 READ AND TYPE CALLING SEQUENCE 


Entry 

Absolute 

Name 

Address 

READ 

813E 

READAH 

813B 

TYPE5D 

819C 

TYPE5 

81 AO 

TYPE6 

81A2 

TYPE 

81A4 

TYPE2 

81AE 

TIMALC 

80FE 

DELAY1 

80EF 

OSTRNG 

83F0 


Input ASCII RF.l, D (if non-standard linkage) 

Same as READ. If hex character, DIGIT RD (see text) 
1.5-bit delay. Then TYPE5 function. 

Output ASCII character at M(R5). Then increment R5. 
Output ASCII character at M(R6). Then increment R6. 
Output ASCII character at RF.l. 

Output hex digit pair in RF.l. 

Read input character and set up control byte in RE.1. 
Initialize RC to point to DELAY1. 

Delay, as function of M(R3) (see text). Then R3 + 1. 
Output ASCII string at M(R6). Data byte 00 ends typeout. 


Notes 

(1) All routines, except DELAY, use R3 as program 
counter, exit with SEP5, and alter registers X, D, 
DF, RE, RF and location M(R2). 

(2) DELAY routing uses RC as program counter. 


exits with SEP3 after incrementing R3, and 
alters registers X, D, DF, and RE. 

(3) READ and READAH exit with R3 pointing 
back at READAH. 

(4) All five TYPE routines exit with R3 pointing 
at TYPE5. 
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Examples of UT20 
Read and Type Usage 

The following examples should help clarify how 
to use the UT20 read and type subroutines. Most 
examples use the standard subroutine linkage which 
require‘s that R2 point at a free RAM location. 

Read Routines 

This sample program will read four ASCII hex 
characters into register RD translating them from 
^SCII to hex in the process. Reading will terminate 
when a carriage return is entered. Entry of a non-hex 
digit other than a carriage return will cause a branch 
to an error program which will type out a “?”. This 
sample program uses the standard subroutine call and 
return linkage. 

READAH=;^8I3B 

LOOP: SEP R4,A(READAH) ..Call the hex 

..read program 
BDF LOOP ..As long as ASCII hex 
..digits are entered 
. .Read and shift in 
..Fall through if not hex 
..character 

GHI RF ..See what character was last 
.. entered 

XRI ^OD .. Was it carriage return 

BNZ ERROR ..Ifnot, BR to error 

..Characters entered are now 
..in RD 


The READ routine (at 813E) could be used 
similarly to enter characters; however, READ only 
enters them one at a time into RF.I (and D) writing 
over the previous entry. Note that, even though 
incoming data is entered into D, the subroutine 
return program alters D. Therefore, valid data will 
only be found in RF.I (and RD when READ AH is 
used) if the standard subroutine call and return 
programs are used. An alternative technique is to use 
R5 as the main program counter (since all read and 
type routines terminate with a SEP R5) and call the 
program with a SEP R3 (since all read and type 
routines use R3 as their program counter). The 
following example illustrates this technique. 


Type Routines 

EXAMPLE 1; This program outputs a single 
character using the TYPES routine. It uses R5 as the 
program counter. 


LDI;«^81 
PHIR3 
LDI MO 
PLOR3 
LDI ^^FF 
PLOR2 
LDI #3F 
PHI R2 
SEP R3 
,T‘R’ 
yy 


♦ ♦Set R3 to TYPES routine 


..Set R2 to free RAM location ;^3FFF 


♦ .Call type 

♦ .An “R” will be typed 

♦ .Next instruction 


The TYPESD routine is used in the same way, 

EXAMPLE 2: This program outputs a character 
using the TYPE6 routine. Note that R6 should be the 
program counter for the program calling TYPE6 if 
the character to be typed is an immediate byte 
because TYPE6 must always be from M(R6). But, 
because TYPE6 exits with SEP S, TYPE6 must 
always be called using standard subroutine linkage 
for typing an immediate byte. An alternative is to use 
RS as the main program counter but point R6 at the 
memory location containing the byte to be typed. 
This example uses standard subroutine linkage. 

SEP R4 ..Branch to the call routine 
A2 . .Address of TYPE6 
,T ?’ ..Byte to be typed out 

yy . .Next instruction 

EXAMPLE 3: The TYPE and TYPE2 routines 
pick up the byte in RF.I for typing. TYPE simply 
outputs the character, whereas TYPE2 considers 
RF.I a hex digit pair which it encodes in ASCII 
before typing. This example types out the hex digits 
’D5’, and uses standard subroutine linkage. 

LDI #D5 ..Load hex digits D5 
PHIRF ..IntoRF.l 

SEP 4 ..CallTYPE2 

,#8IAE 

yy ..Next instruction 

Note that all type routines, except TYPE2, 
expect the character they pick up to be already en¬ 
coded in ASCII. 


EXAMPLE 4; An entire message can be typed 
by using the OSTRNG routine. The ASCII bytes 
pointed to by R6 will be typed. When a ‘00’ byte is 
detected, OSTRNG returns to the caller. This 
example will output the string 

RCA COSMAC 
MICROPROCESSOR 

The standard call and return linkage is assumed. 
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OSTRNG = ii'SSFO 


SEPR4,A(OSTRNG) ..Call OSTRNG 

DCT'RCACOSMAC’ ..1st Line 

‘ ,/yODOA ..(CRKLF) 

,TMICROPROCESSOR’..2nd Line 

..End of Text 


A 

Additional 
Utility Routines 

ASCII to Hex 
Conversion Routine 

The ASCII to hex conversion, CKHEX, 
examines the ASCII character in RF.L If this 
character is not a hex digit, CKHEX returns to the 
user (via SEP RS) with DF = 0. If the character is 
liex, CKHEX retiurns with RE.O = hex digit, DF — 
I and with the digit shifted into the least significant 4 
bits of register RD. CKHEX uses the registers 
described above and, as with the other routines, is 
most readily handled via the standard call and return 
techniques. CKHEX is located at 83FC. 

Initialization Routines 

Two routines are provided, INITl and INIT2, 
which initialize CPU registers for the standard call 
and return technique. These routines set up registers 
as follows; 

R2 = R(X1 - pointing to the last (highest) 
available user RAM location 
(below 8000). 

R8 - will become the program counter 

on return 

R4 - pointing to the call routine in 

UT20 

Ro - pointing to the return routine in 

UT20 

The INIT programs examine user memory area 
(below address 8000) and determine how much 
memory is present. They set R2 to the highest 
available RAM address, which is 03FF for the CDS 
as su[)plied (with one 4-kilobyte RAM card). 


The only difference between INITl and INIT2 
is the location to which they return. INITl returns to 
location 0003 with P = 3, while INIT2 simply 
returns by setting P = 3 and assumes that the user 
has already set R3 pointing to the correct return 
point. These programs are intended as a convenience 
to lr(‘e the user from generating the overhead code 
reciuired by the standard subroutine technique. They 
ma\ also be used as an integral part of custom 
su[)i)ort programs running on the CDS. Their ab¬ 
solute addresses are INITl = 83F3 and'INIT2 = 
8.3fb. Refer to Appendix G, the UT20 listing, for the 
ab.solute addresses of CALL and RET, which will be 
loaded into R4 and R3 respectively. 

Following are examples of the use of these 
programs: 


EXAMPLE 1: Using INITl 

INITl = mF3 

Address Code Mnemonics Comment 

0000 71 DIS,^00 ..Disable interrupts 

0001 00 

0002 Co LBR INITl ..Initialize registers 
0003 83 

0004 F3 

0005 -- USRPGM:-- ..User program starts here; 

..P-3 


EXAMPLE 2: Using INIT2 

INIT2 - ;y83F6 


Atlclress 

s (]<>de Mncmionics Comment 

()()()() 

71 

DLS.i^^OO ..Disable interrupts 

0001 

00 


0002 

F8 

LDIA.l ..Set R3 to return 



(START) 

0003 

00 

..point 

0004 

B3 

FHI R3 

0005 

F8 

LDI A.O 



(START) 

000() 

50 


0007 

A3 

PLO R3 

0008 

CO 

LBRINIT2 ..CallINTr2 

0000 

83 


OOOA 

F() 


0050 

__ 

START:-- ..User program starts 


..P =3 


i 


j 
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Routine to Restart UT20 

A means is provided to automaticalK transfer 
control back to UT2() from a user program. An entry 
point routine. G()lJT2(f, is provided for this purpose. 
When entered via this routine, UT20 will restart and 
issue a * prompt to the terminal. A long branch to 
GOLT^O at location will cause this transfer. 

LT2() depends on the following conditions upon re- 
(‘iitr\: 

1 ) KK. 1 = terminal timing constant 
21 Two-level I/O is enabled 

In order to assure the second condition, the user 
program must be initiated via the $U command. The 
GOUT20 routine can be called only by a program 
having R3 as its program counter. 

Additional Notes on UT20 

1jT 20 automatically enables group 1 I/O devices, 


which includes the terminal and floppy disk in¬ 
terfaces. when it is started. User-added I/O devices 
win'd to the same group-select signal are also 
enabled. For more information on this subject, refer 
to “Two-Level I/O” under Inpul/Output Inter¬ 
facing in the next Section, titled Hardware 
Structure of the CDS. 


Internipts are automatically disabled when U r20 
is running. They are re-enabled by either the SP or 
SU command. Because Rl and R2 must be initialized 
by a user program before interrupts are allowed, 
LT20 prohibits siarl-up via these commands if an 
Interrupt is pending. Instead, it will type IN- 
TFRRUP r and issue an *. 'Phis feature is a con¬ 
venience to the user to prevent start-up problems if 
interrupts have not been externally disabled. If 
custom hardware is installed that may cause in¬ 
terrupts at start-up, the user program should be 
started via the RUN P switch. 


Programming Methods 


Machine Language 
Programming 

With an understanding of the structure and 
()|HTation of ihe CrU and ihe material provided thus 
far. the reader is prepared to begin using 'the 
Development System in an elementary way. For 
example, he ean now understand and possibly modify 
ibe lime-out lest program presented earlier in this 
Manual. However, almost any hexadecimal I machine 
language) test program will recjidre use of the I/O 
typewriter, 'Fhe most basic way to communicate by 
tile teletypewriter, therefore, will be covered next. 

To read a eharacter from the I/O teletypewriter, 
the user program should transfer control to READ* 
(in UT2()). That is. load R3 with 8i:iE and execute a 
D3 instruction, making sure that R2 is pointing to a 
free RAM location. After the typed character is read, 
the utility routine will return by setting P to 5, i.e., by 
executing the instruction D") (making it most con¬ 
venient if the program counter of the calling routine 
were 5 to begin with). Tlie ASCII code for the input 
character (with a 0 parity bit) will be in both RF.l 
and in D. The memory location pointed to by R 2 and 
registers RE, RF, X, and DF will have been changed 
in value (not preserved over the call). 


•a list ot key UT20 symbolic locations and their corresponding 
absolute memory addresses is given in Table II. 


Because the READ routine uses R3 as its program 
counter, it is most convenient to branch to READ by 
a D3 instruction. When READ returns to the caller, 
R3.0 will contain a modified value, necessitating 
another initialization if a repeated I/O is to be per¬ 
formed. Because the READ routine uses the values in 
registers RC and RE which UT20 will normally 
initialize, it is essential that the user refrain from 
using these registers unless their values are saved and 
later restored by his program. 

To cause a character to be typed out by the I/O 
typewriter, the user program should transfer control 
to TYPE5D at location 819C, by means of a D3 
instruction, again making sure that R2 is pointing to 
a free RAM location. As discussed above, the calling 
P value should be 5 and, for this case, the ASCII code 
for the output character should be an immediate byte 
(i.e., the byte after the D3 instruction). After typing 
the character, READ will have advance R5 past the 
argument byte and again return by a D5 execution. 
M(R(2)), as well as registers RE, RF, X, D, DF, and 
R3.0 return altered. All other register values are 
preserved. For the reasons previously cited, the user 
should again refrain from using registers RC and RE. 

Given the ability to execute simple I/O terminal 
functions, the user can now code elementary test 
programs to further exercise the COSMAC 
Development System. As a simple example, consider 
the routine shown in Fig. 3 that reads two bytes, 
compares them, and outputs the larger of the two. 
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MEMORY 

HEX CODE 


LOCATION 

STORED 

COMMENTS 

00 

90 

00 ^ D. (Assumes R0.1 = 0). 

01 

B2 B5 B6 

Clear upper half of pointers. 

04 

F8 FF A2 

M(OOFF) is the free RAM location. 

07 

F8 81 B3 

Initialize upper half of I/O call program counter. 

OA 

F8 3E A7 

Lower half of READ address saved in R7.0. 

OD 

F8 9C B7 

Lower half of TYPE address saved in R7.1. 

10 

F8 27 A6 

R6 now points to 0027 (the immediate TYPE byte). 

13 

F8 17 A5 

R5 initialized to 0017 is ready to be the program counter. 

16 

D5 

Change P from 0 to 5. 

17 

87 A3 

R3 now points to READ routine (813E). 

19 

D3 

Call READ. Input character to D and RF.1. 

1A 

56 

Save first character in immediate byte location. 

IB 

87 A3 D3 

READ second character. 

IE 

E6 

X now points to first character. 

IF 

F7 

D — M(R(X)) D. Subtract first character from second. 

20 

3B 24 

Print the first character if it is the largest. 

22 

9F56 

Second character moved to immediate byte location. 

24 

97 A3 

R3 now points to TYPE5D (at 819C). 

26 

D3 

Call TYPE. Output byte at the next location (0027). 

27 

00 

Immediate byte storage for TYPE routine. 

28 

30 17 

Loop for another pass. 


Fig. 3'~ Example of elementary hexadecimal program. 


The routine given exhibits register usage compatible 
with the UT20 READ and TYPE calling sequences. 
Further, the I/O instructions consist of calls to the 
appropriate teletypewriter interface routines. 

The initialization part of the program is above the 
dashed line. The main program loop begins at 
location 17. Each call to the utility program (two 
read’s and one TYPE) is made by a D3 execution 
after first initializing R3.0 with the proper half of R7 
in which the two lower half address constants (9C and 
3E) are stored. R3.1 continues to hold its 
initialization value of 81. Two characters are read and 
a subtraction is executed. The resulting immediate 
TYPE byte is conditional on the results of the sub¬ 
traction. The free RAM location used by READ and 
TYPE is OOFF in this case since R2=00FF. 

The initialization part of the program is executed 
with P == 0. R5 is the program counter once the main 
program loop is entered at location 17. R6 is 
initialized to point to the immediate TYPE argument 
location (0027). Notice that X is set to the value 6 (see 
instruction at location IE) after the READ routine 
since READ changes the value of X. 

An example of loading and running a program by 
means of the keyboard is a CDS “session” using the 
elementary program just discussed. In what follows, 
underlined text represents UT20 printout; text not 
underlined represents user input; bracketed text is 
commentary. 


Begin by turning power ON and pressing RESET, 
followed by RUNU. The RUN light will go on. Then 

(CR) [Carriage Return to establish timing 
constant and echo] 

-* [UT20 prompt character] 

!MO 90 B2 B5 B6 F8 FF A2 F8, (CR) (LF) 

81 B3 F8 3E A7 F8 9C B7, (CR)(LF) 

F827 A6 F817 A5 D5 87, (CR) (LF) 

A3 D3 56 87 A3 D3 E6 F7, (CR) (LF) 

3B 24 9F 56 97 A3 D3 00, (CR) (LF) 

3017 (CR) 

[The program has now been loaded] 

JL [UT20 ready for the next command] 
SU(CR)[Begin program execution] 
ABBBAB122211MNN [..etc..] 

Each character triplet represents one pass through 
the main program [oop consisting of two user input 
characters and one output character. 

The reader may wish to code his own program at 
this point to verify his knowledge of the CPU in¬ 
struction set and the read and type routines. 
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Programming Interface 
to CSDP 

Machine language coding, even of a trivial 
program, should convince the novice programmer 
that to do any serious programming, one should take 
advantage of the set of software support aids 
available. Veterans in the programming community 
are already aware of the fundamental necessity for 
assembly and simulation facilities. Support services 
are available either by timesharing, i.e., using a 
system of RCA-developed programs hereafter 
referred to as CSDP, or by this Development System 
itself. The user manual for the former set of programs 
is the Timesharing Manual for the CDP1802 
COSMAC Microprocessor, MPM-202. For the 
latter set of programs it is this manual. To do any 
non-trivial programming, it is essential that the 
reader be familiar with the facilities provided by these 
software support systems. If the reader is not using 
CSDP, he should skip this section. 

As discussed in the Timesharing Manual for the 
RCA CDP1802 COSMAC Microprocessor, MPM- 
202, much of program development by CSDP is 
accomplished without direct CDS involvement. 
Typically, a source file is constructed, assembled, 
edited (if the assembler objects to the source code), 
reassembled,...,etc. The simulator is used to run the 
program, during which time program bugs are 
isolated and removed by further editing and 
reassembly of the source file. Eventually, the object 
code is ready for loading and running in the real 
hardware (the COSMAC Development System) for 
further testing. It is this part of the process that is of 
concern here. 

Already discussed has been the use of the MM’ 
utility program to load the CDS RAM from the 
keyboard or from tape. One ultimate purpose of the 
CSDP system is to generate an object code file, 
compatible with the required !M format, and (on 
command) to transmit this file over the telephone link 
to the CDS system. Clearly, it is possible for the user 
to write this file onto a tape and subsequently load the 
CDS using this medium. Of concern here, however, is 
the automatic mechanism by which the ! M- 
compatible object file coming over the telephone line 
is loaded into the CDS RAM directly. 

There are three different data communication 
paths. First is the I/O teletypewriter-CDS path, 
already discussed. Second is the I/O teletypewriter- 
Timesharing System link, via an appropriate modem, 
which is implied in the use of CSDP for assembly and 
simulation. And third is the Timesharing System- 
CDS link (again via a modem) which is essential to 
the automatic, direct-load process. 


Some switching mechanism is implied by which the 
Development System serial “Terminal” input signal 
can come either from the keyboard/tape reader or 
from the modem carrying data generated by CSDP. 

A teletypewriter unit, for instance, requires an 
external modem (e.g., an acoustic coupler or a‘data 
set), and an added external “switchbox” to 
mechanize the various TTY-CDS, TTY-modem, and 
modem-CDS paths. It should be an appropriately 
wired three-position switch. In the “TTY CDS” 
position the terminal acts as the I/O device for the 
CDS. In the “TTY-TIMESHARING” position, it 
acts as normal timesharing terminal. In the 
“TIMESHARING-LOAD” position, the link is 
established to allow data from the timesharing system 
to be automatically loaded into the CDS memor>. 

If it is assumed that the user has been using the 
CSDP control program and that an object code file, 
previously assembled by CSDP, is ready for tran¬ 
smission, the steps required to effect an automatic 
load of the CDS RAM follow. 

Because CSDP will transmit an ! M-compatible 
object file on command from the terminal, it is 
necessary to properly initialize the utility program so 
that it is ready for this input. This initialization is 
done by temporarily switching the terminal to ac¬ 
tivate the TTY-CDS path only, and pressing 
RESET, followed by RUNU, followed by the 
keyboard echo-timing control character LF. 
Initialization will be followed by a return of the 
prompt character indicating that UT20 is ready. It 
will then ignore all subsequent inputs until a ! or ? or 
$ is detected. It is essential that this local initialization 
be done at a time before the final carriage 
RETURN, which terminates the “transmit” com¬ 
mand to CSDP, yet after the occurrence of any 
characters in this command string recognizable by 
UT20. Thus, the final “transmit object file” com¬ 
mand to CSDP is begun in the TTY- 
TIMESHARING mode. At the proper point, UT20 
initialization occurs, as discussed above. Then, the 
terminal is switched back to TIMESHARING 
LOAD and the command is completed. All sub¬ 
sequent characters are ignored by UT20 until it 
receives the loading !M indicating the beginning of 
object file transmission; 

CSDP indicates that it is ready for a user command 
when it outputs to the terminal the prompt characters 
DBG. Assuming that the assembled file is ready for 
transmission, the following two alternative CSDP 
commands will effect the transmission: 

1. SXA File Name A Start RAM Location A 
End RAM Location where File Name is the 
name of the file or the device which will 








Operating and Programming the CDS 


23 


receive the specified contents of CSDP’s 
simulator memory. These contents are nor¬ 
mally object-code generated as the result of a 
just-completed assembly. If File Name is 
specified as TTY, the object code will be 
transmitted over the telephone line to the 
terminal. For example, 

SXTTY//0^1FF(CR) 

will result in the transmission of the comma- 
continuation form of the !M object file, 
■V loading the lowest part ( 200]^5 bytes) of the 

CDS RAM. (Recall that the utility program 
must be properly initialized just prior to the 
final CR.) The IMform is more compact and 
“relocatable”. 

2. SYA File Name A Start RAM LOC A End 
RAM Loc where the same comments above 
apply to File Name. For example, 

SYTTY #20y^l50(CR) 

will result in the transmission of the semicolon- 
continuation form of the '!M file (more 
readable, since each line begins with an ad¬ 
dress value). This form is particularly useful 
for “scatter loading” of subroutines or other 
memory patches. 

If the CDS has been initialized properly, just 
befoH' the transmission begins, the object file will be 
loaded into RAM automatically. The user can then 
|)r()cee(l to run the program with the I/O data ter¬ 
minal in TTY-CDS mode, using standard CDS 
facilities, i.e., SP or $U by means of the utility 
program or a RESET, RUN P sequence. 

An example follows of a CSDP-Development 
SNstem session using a Level-1 assembly language 
v(Tsion of the sample program given in Fig. 3. The 
source program is listed in Fig. 4. For this example, 
the program is written to begin at memory location 
0001 to illustrate use of the ORG statement. The 
comments in the listing should be sufficient to permit 
the reader to establish correspondence with the 
detailed hex code in Fig. 3. Assume that this source 
program is entered from the keyboard into the 
timesharing system, as a file named SAMPLE. Once 
this entry is made, the user calls for activation of the 
CSDP program. When CSDP is ready for a com¬ 
mand, it prompts the terminal with the DBG 
message. By entering the CSDP command $A 
SAMPLE, TTY (CR), the user calls for an assembly 
of this file with listing and diagnostics printed to the 


terminal. The output received is indicated in Fig. 
3 * . The code listed there (the same as that in the hex 
program generated earlier) has now been loaded into 
the CSDP simulator’s memory. After generating the 
listing, CSDP again returns with the DBG prompt. 

At this point, the user follows the instructions given 
earlier, that is, input of the $X or $Y command with 
appropriate UT20 initialization, to effect an 
automatic load of the object file into the CDS RAM. 
The sequence of steps is as follows: 

1 . Begin the transmit command to CSDP by 
typing S a TTY ^0 #30 (where “ a ” is either 
X or Y), but without typing the final carriage 
RETURN yet. 

2 . Switch the terminal to the TTY-CDS mode, 

3. Press RESET, RUNU, CR or LF (for full or 
half duplex), and receive the * prompt as an 
answer from the utility program. 

4. Switch back to TTY-MODEM mode. Switch 
the selector switch to the “CSDP LOAD” 
position at this point. 

5. Press the final carriage RETURN, ter¬ 
minating the CSDP transmit command. For 
this case, bytes will be transmitted. 

While the object file is being transmitted to the 
Development System, it is also printed on the data 
terminal. For the example given, the CSDP com¬ 
mand SX TTY #0 #30 will result in 

IMOOOO 

FF00B2B5B6FHFFA2F881B3F83EA7F89CB7F828A6, 

F8 18ASp587A3D35687A3D3E6F73B2'59F569.7A3D3, 

FF3018FFFFFFFFFFFF 

DBG 

printed on the terminal during the loading of RAM. 
On the other hand, for the same example, the CSDP 
command SY TTY #0 #30 will result in 


• Refer to the Timesharing Manual for the RCA CDP1802 
COSMAC Microprocessor, MPM-202, for detailed CSDP 
user instructions and an explanation of the assembly 
listing format. Note that for forward references, the 
code displayed in the listing does not correspond exactly 
to the contents of the simulated memory. 
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!M 

()()()() FF90 
0010 BTF« 
0020 ft:5B 
00:50 FF 
DBG 


B2B.T B()F« FFA2 F881 B3F8 3EAT F80C; 
28A6 F8I8 A3DS 87A:} D3.7() 87A3 D3E6: 
230F 3097 A3D3 0030 18FF FFFF FFFF; 


loading, via the 
program. 

RDPTR = #3E .. LOWER HALF READ ENTRY 

WRPTR = #9C . . LOWER HALF TYPE5D ENTRY 

10 = R3 . . UTS READ-TYPE PROGRAM COUNTER 

PC=R5 .. CALLING PROGRAM COUNTER 

ARG = R6 . . POINTER TO IMMEDIATE TYPE BYTE 

lOPTR = R7 . . HOLDS WRPTR AND RDPTR VALUES 

ORGiWI .. PROGRAM STARTS AT LOC 1 

.INITIALIZATION PHASE BEGINS HERE. 

. . CLEAR D, SINCE R0.1 IS ZERO 


printed on the terminal during the loading process. 
Notice that, after completion of transmission. CSDP 
comes back in its command mode with the DBG 
prompt. 

The user may now log off from the timesharing 
system after a "SQ" to CSDP and then switch the 
data terminal to the TTY-CDS mode to verify 
.'M command, and to run the 


GHI RO 

PHI R2 

PLO R2 

PHI PC 

PHI ARG 

LDI #81 

PHI 10 

LDI RDPTR 

PLOlOPTR 

LDI WRPTR 

PHIlOPTR 

LDI A. 0 (ARG1) 

PLO ARG 

LDI A. 0 (LOOP) 

PLO PC 

SEP PC 


R2 POINTS AT FREE LOC (ZERO) 


CLEAR UPPER HALVES OF LOCAL PTRS 


INITIALIZE UPPER HALF UTS PC 


LOWER HALVES OF UTS ENTRIES 

POINTER TO TYPE SAVE BYTE 

LOCAL PROGRAM COUNTER READY 
SWITCH PROGRAM COUNTERS 


# 


.MAIN PROGRAM LOOP BEGINS HERE 

LOOP: GLO lOPTR 


PLO 10 
SEP 10 
STR ARG 
GLO lOPTR 
PLO 10 
SEP 10 
SEX ARG 
SM 

BM TYPE 

GHI RF 

STR ARG 

TYPE: GHI lOPTR 

PLO 10 

SEP 10 

ARG1: ORG*+#01 

BR LOOP 

END 


POINT TO READ 
CALL READ. FIRST CHAR TO D 
SAVE IT 

REPOINT TO READ 

CALL READ. SECOND CHAR TO D, RF . 1 
RESTORE ARG POINTER 
, SECOND CHAR MINUS FIRST 
, EXIT IF FIRST CHAR IS LARGER 

. . SECOND CHAR TO OUTPUT ARG LOC 

. . POINT TO TYPE5D 
. . CALL TYPE. 

IMMEDIATE BYTE ARG AND SAVE LOC 
. . LOOP FOR ANOTHER PASS 

Fig. 4 — Source code of sample program for CSDP 
timesharing assembler. 
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m 


DBG $A SAMPLE, TTY 


m 


m 


0000 

1 

RDPTR = #3E 

. LOWER HALF READ ENTRY 

0000 

2 

WRPTR = me 

. LOWER HALF TYPE5D ENTRY 

opoo 

3 

o 

II 

00 

. UT3 READ-TYPE PROGRAM COUNTER 

0000 

4 

LD 

oc 

II 

o 

a. 

. CALLING PROGRAM COUNTER 

^ 0000 

5 

ARG = R6 

. POINTER TO IMMEDIATE TYPE BYTE 

0000 

6 

lOPTR = R7 

. HOLDS WRPTR AND RDPTR VALUES 

0001 

7 

ORG #)1 

. PROGRAM STARTS AT LOC 1 

0001 

8 

INITIALIZATION PFIASE BEGINS HERE. 

0001 90 

9 

GHI RO 

. CLEAR D, SINCE R0.1 IS ZERO 

0002 B2 

10 

PHI R2 


0003 A2 

11 

PLO R2 

. R2 POINTS AT FREE LOC (ZERO) 

0004 B5 

12 

PHI PC 


0005 B6 

13 

PHI ARG 

. CLEAR UPPER HALVES OE LOCAL PTRS 

0006 F881 

14 

LDI #81 


0008 B3 

15 

PHI 10 

, INITIALIZE UPPER HALE UT3 PC 

0009 F83E 

16 

LDI RDPTR 


OOOB A7 

17 

PLO lOPTR 


OOOC F89C 

18 

LDI WRPTR 


OOOE 87 

, 19 

PHI lOPTR 

LOWER HALVES OF UT3 ENTRIES 

F 000F F800 

20 

LDI A.O (ARGl) 


0011 A6 

21 

PLO ARG 

. POINTER TO TYPE SAVE BYTE 

F 0012 F800 

22 

LDI A.O (LOOP) 


0014 A5 

23 

PLO PC 

. LOCAL PROGRAM COUNTER READY 

0015 D5 

24 

SEP PC 

. SWITCH PROGRAM COUNTERS 

0016 

25 

MAIN PROGRAM LOOP BEGINS HERE 

0016 87 

26 

LOOP: GLO lOPTR 


0017 A3 

27 

PLO 10 

. POINT TO READ 

0018 D3 

28 

SEP 10 

. CALL READ. EIRST CHAR TO D 

0019 56 

29 

STR ARG 

. . SAVE IT 

001A 87 

30 

GLO lOPTR 


0018 A3 

31 

PLO 10 

, REPOINT TO READ 

001C D3 

32 

SEP 10 

CALL READ. SECOND CHAR TO D, RF.1 

001D E6 

33 

SEX ARG 

. . RESTORE ARG POINTER 

001E F7 

34 

SM 

. SECOND CHAR MINUS EIRST 

F 001F 3800 

35 

BM TYPE 

. . EXIT IE FIRST CHAR IS LARGER 

0021 9F 

36 

GHI RF 


0022 56 

37 

STR ARG 

. . SECOND CHAR TO OUTPUT ARG LOC 

0023 97 

38 

TYPE; GHI lOPTR 


0024 A3 

39 

PLO 10 

. . POINT TO TYPE5D 

0025 D3 

40 

SEP 10 

. . CALL TYPE. 

0027 

41 

ARGl: ORG*+#01 

. . IMMEDIATE BYTE ARG AND SAVE LOC 

0027 3016 

42 

BR LOOP 

. . LOOP FOR ANOTHER PASS 

0029 

43 

END 


NO UNDEFINED LA8ELS 




NO UNDEFINED SYMBOLICS 




DBG 





Fig. 5 - 

CSDP assembly listing for sample program. 
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Hardware Structure 
of the CDS 


This section of the manual is organized to a present 
a “top down” explanation of the hardware structure 
of the COSMAC Development System. First, an 
over-all system block diagram is given containing 
sufficient detail to explain the basic functions of each 
of the modules and to indicate all of the essential data 
and control paths in the system. A few “second- 
order” signals are omitted at this stage for simplicity. 
This overall diagram is followed by a block diagram 
of each of the modules. These diagrams are designed 
to provide sufficient detail (signal mnemonics, timing 


information, etc.) so that fiu*ther user analysis of the 
individual module logic diagrams (given in Appendix 
D) should be unnecessary. The assignment of con¬ 
nector pins to signals is omitted at this point. This 
detail is found in the backplane wiring schedule in 
Appendix A. 

A fundamental prerequisite to understanding the 
structure of the CDS is a detailed familiarity with the 
COSMAC CPU interface and instruction set, as 
described in the User Manual for the RCA CD- 
P1802 COSMAC Microprocessor, MPM-201. 


System 
Block Diagram 


The broad organization of the Development 
System is indicated in Fig. 6. The CPU module in¬ 
terfaces with an I/O system to its right in the diagram 
and with a memory system to its left. The switches 
and indicators on the Control Panel (at the top of the 
diagram) communicate with the system through the 
CLOCK and CONTROL Module, which also 
contains the system clock. 

Most of the signal paths in the diagram are labeled 
with signal mnemonics in parentheses. The notation 
(i:j) is used to denote a parallel set of signals, each 
labeled with a unique index in the range i to j. Thus, 
for example, A(14:12) represents the bundle of three 
parallel signals A14, A13 and A12. Note further that 


where additional emphasis is required to distinguish it 
from the letter “O”, a is used for the numeral 
zero. 

The superscript after each module name in the 
diagram denotes the plug-in connector position or slot 
number in the CDS next to which the module is 
assigned. 

Physically, the Development System consists of a 
card nest with 25 sockets for logic cards in¬ 
terconnected by means of a printed circuit backplane, 
a power supply, a chassis which will mount via a 19 
rack or a cabinet, and a hinged panel on which are 
mounted control switches and indicators. 
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The control and Display Panel has a PC board on 
which are mounted the switches, displays, and 
associated electronics. Via a cable, it communicates 
with the control module which is inserted into the 
card nest. The Control module contains circuits to de¬ 
bounce the switches, interface then to the CPU, and 
perform some logic control and timing. The Control 
module communicates with the CPU module via 
wires printed on the backplane. 

The CPU module consists of the CDP1802 with a 
crystal for the on-chip oscillator and electrical buffers 
for the Data and Address Buses. The CPU module is 
central to the system, communicating with the I/O 
and Memory systems to the right and left respectively 
in the diagram. 

On the memory side, the Address Latch and Bank 
Select module, as its name implies, latches the high- 
order Memory Address Byte and decodes it into 16 
unique Bank Select lines, for use by the entire 
memory system. On the I/O side, the I/O Decode 
module accepts the N lines from the CPU, and 


decodes them into 7 unique lines, N = 1 through N 
= 7 for use by all I/O controllers. In addition, it 
latches the Data Bus on a (61)^5 instruction, and 
provides eight Select lines for use by all I/O con¬ 
trollers as two-level I/O addressing. 

Two memory modules are provided, the 
ROM/RAM and the 4-kilobyte RAM. The 
ROM/RAM module holds the system’s Utility 
program ROM (UT20) plus a small (32-byte) RAM 
for use by that Utility. The 4-kilobyte RAM module 
provides 4 kilobytes of static RAM storage. 
Additional 4-kilobyte RAM modifications may be 
added pre-wired expansion slots. 

A Terminal Interface Module is provided, which 
may be used to communicate with terminals having 
either the EIA or 20-mA current-loop interface. 

All memory and I/O controller modules attach to A 
the common DATA BUS, which is bi-directional. “ 
Therefore, these modules must provide a means for 
disconnecting from the bus, when not using the bus, 
such as tri-state buffers or transmission gates. 
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The various control, flags, etc. are distributed to 
the I/O and memory expansion locations on the 
l)ackplane. Module select lines, BANK SELECT for 


memory and SELECT for I/O, are not wired on the 
backplane PC board, but are available for wire-wrap 
connections as determined by user system con¬ 
figurations. 


Module Description 
and Signal Mnemonics 


' Each standard module will be described using a 
simplified logic or Block diagram. Detailed logic 
diagrams may be found in Appendix D. 

Signal naming conventions are as follows: 

The signal name is followed by a hyphen and 
either the letter N or P. The suffix N means the signal 
is asserted (true) when that wire is at groiuid. The 
suffix P means the signal is asserted (true) when that 
wire is at the highest logic level (+5 V). Thus the 
signal name gives the meaning assigned to that 
conductor, and the suffix defines the electrical value 
of the asserted (true) state. 

A bimdle of parallel signals is indicated by a (i:j) 
notation in the signal name denoting a running index 
over the range i to j and by the number of parallel 
signals (in parentheses) labeling the signal path. 
Inputs which are pulled high or low on the module are 
indicated with resistor symbols to V£)p) or to GND. 
If such an input is not used (not connected), it 
assumes the high/low level defined by its “pull 
up/down ’ resistor. Output signals which are derived 
from CMOS transmission gates are labeled with a 
“(Tl ” in the diagrams. Such outputs may be bussed 
(“wire-OR’ed”) together - assuming only one tran¬ 
smission gate is enabled at a time. An output derived 
from a transmission gate may also be pulled high or 
low with a resistor on the board. 


Card Nest and Backplane 

The backplane of the Card Nest is a double-sided 
PC board mounted on the back of the CDS. It in¬ 
terconnects the pins of the first 25 of the 33 available 
connector positions. Some of these positions are 
occupied with supplied modules, as indicated in 
Table III. The card positions, viewed from the back, 
are numbered from left to right. 


TABLE III - MODULE POSITION 
ASSIGNMENTS IN NEST 

Connector 

Position 


Number 

Module 

Part Number 

1 

Memory Bus 


2 

Memory Bus 


3 

Memory Bus 


4 

Memory Bus 


5 

Memory Bus 


6 

Memory Bus 


7 

Memory Bus 


8 

4-Kilobyte RAM 

CDP18S205 

9 

ROM/RAM 

CDP18S401 

10 

Address Latch and 



Memory Bank Select 

CDP18S206 

11 

Blank 


12 

CPU 

CDP18S102 

13 

I/O Decode 

CDP18S509 

14 

Terminal Interface 

CDP18S507 

15 

I/O Bus 


16 

I/O Bus 


17 

I/O Bus 


18 

I/O Bus 


19 

I/O Bus 


20 

I/O Bus 


21 

I/O Bus 


22 

I/O Bus 


23 

I/O Bus 


24 

(Floppy Disk Interface) 

CDP18S813 

25 

Control 

CDP18S103 

26 - 32 

Power Supply 



The backplane wiring schedule in Appendix A 
indicates the following types of connection: unused 
pins, pins interconnected by printed wiring, pins 
interconnected by a wire-wrap, and pins not con¬ 
nected on the backplane but which have meaning 
defined by the plugged-in module. A dash indicates 
an unused pin, In all cases, identically named signals 
are interconnected. The backplane is laid out so that 
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signal flow is horizontal, i.e., wherever possible the 
printed wiring connects identical pins on different 
connectors. Note that almost all of the printed signal 
interconnections are made on the exposed side of the 
backplane. If the user wishes to modify the backplane 
wiring for some reason, he can scratch out undesired 
connections and wrap his own. 

One notational inconvenience between the CDS 
documentation and the data sheet for the CDP1802 
microprocessor should be explained. In the CDS, the 
power supply voltage (+5 volts) is the standard 

high signal level. This voltage is connected on the 
CPU plug-in board to the microprocessor pin (16) 
labeled ’ on the CDP1802 data sheet. The 

label ’ is not used in CDS documentation. 

Another microprocessor pin (40) may be connected to 
a higher power supply voltage level to achieve higher 
speed, if desired. In the CDS, this pin is connected to 
the power supply voltage labeled “CPUPWR” 
(whose level may be 5 volts or higher). The CDP1802 
data sheet labels this pin as For a CDS for 

which both positive CPU supply voltages are at 5 
volts, the user should not be confused by these 
alternative notations. A ground strap is provided 
connecting logic ground to chassis. It may be 
removed by the user if he has' an alternate safety 
ground in his system. 

Each of the solid boxes in the CDS Block Diagram 
of Fig. 6 corresponds to a supplied module. Both the 
Block Diagram and the backplane wiring schedule 
show the modules generally left to right as they ap¬ 
pear when viewed from the backplane side. From the 
front, memory is on the right and the I/O side of the 
system is on the left. 

Some precaution should be exercised in removing 
and inserting modules into the CDS nest. The module 


cards are keyed so that they cannot be inserted in 
improper positions or with improper orientation. 
However, it is possible for a key to be pulled out by a 
card removal. When removing a card, care should be 
taken to exert a lateral force, without twisting the 
card imnecessarily. It is also possible for a connector 
contact to be dislodged as a result of improper card 
removal. A short across to an adjacent contact (1 to A 
or A to B, for example) can then occur. If trouble 
develops after a card removal and later reinsertion, 
careful inspection of the connector involved is ad¬ 
visable before attributing the problem to failed 
electronics. 

Special care should be taken when cards are in¬ 
serted into or removed from the extender card socket 
because the socket has no key to limit harmful up- 
and-down motion or improper card slot insertion. 

CPU Module CDP18S102 

The CPU is the heart of the COSMAC 
Development System. It controls and addresses 
memory, multiplexing the sixteen-bit memory ad¬ 
dress over a one-byte memory address bus. It 
manages a bidirectional one-byte data bus. It senses 
and reacts to external signals - interrupt, DMA input 
request, DMA output request, and four external 
flags. It transmits two timing pulses, or syncs, and an 
encoded CPU state. When executing an input/output 
instruction (I = 6), it transmits the three-bit “N” 
field of the instruction. Refer to the User Manual for 
the CDP1802 COSMAC Microprocessor, MPM- 
201, for details of the CPU operation. 

Fig. 7 shows the basic logic contained on this 
circuit module. All named signals are brought to the 
backplane connector for use by the system. 
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The internal oscillator on the CDP1802 is utilized 
with a 2-MHz crystal. This oscillator provides the 
internal clocks used by the microprocessor. A buf¬ 
fered clock output is provided for use by any user- 
developed module requiring a controlled clock. The 
user may remove the crystal, then provide an external 
clock by driving pin 12 of this module with an ap¬ 
propriate clock signal. 

The Data Bus is buffered by a set of tri-state driver 
circuits as shown. The drivers on each line are 
connected head-to-tail, and controlled as to direction. 
^When MRD-N is true, the output of gate B is high, 
enabling the inbound tri-state driver to transmit. 
Because outbound drivers require a low level to 
transmit, they are in a high-impedance state 
(disconnect) when MRD is true. When MRD is false, 
the opposite direction is enabled unless an I/O 
operation is in progress, in which case gate A turns on 
llie inbound devices. The reason for the inbound path 
during an I/O operation is so that when an input 
instruction is executed, the data byte may be stored in 
tlie D Register of the CPU as well as in memory. 

The memory address lines are buffered and sent to 
tlie backplane as A(7:())-P. 

The incoming signals EF1-N,EF2-N,EF3-N,EF4- 
N,INT-N,DMAIN-N, and DMAOUT-N, being 
negative signals, have pull-up resistors so that when 
no connection is made, the inputs are logically false. 
Users of these lines should provide tri-state drivers or 
transmission gates to pull them to ground so that 
more than one device may use each line in a wired-or 
manner. 


Power to the CDP1802 is connected to two pins; 
pin 16 powers the chip interface circuits and 

pin 40 (Vj)p)) powers the internal circuits. These pins 
are’connected to backplane connector pins Y and 21 
and pin X respectively and connected together via 
link LK2. To operate with a higher voltage on Vp )]3 
in order to gain speed, cut LK2 and provide a higher 
voltage on pin X. Consult the CDP1802 data sheet 
for maximum voltage ratings. 

It is necessary that, at all times, Vqq < Vp)]^. For 
this reason, it is recommended that a diode replace 
LK2 as shown in Fig. 7, and that a current-limiting 
resistor (approximately 1 kilohm) replace LKl. These 
additions will prevent possible damage to the device 
from raising +Vp)p) without a voltage on CPUPWR. 
The resistor is to limit the ciurent that +Vp )]3 may 
drive into Pin X imder those circumstances. 


Control Module CDP18S103 

The Control Module provides the interface bet¬ 
ween the control/display panel and the system logic. 
See Fig. 8. 

The control panel switch contacts are brought to 
the control module via connector Jl. These lines are 
interfaced with appropriate de-bounce or pull-up 
circuits and logic to control the CPU mode. 

The WAIT-N and CLEAR-N inputs to the 
CDP1802 are controlled to produce one of the four 
control modes: RESET, RUN, LOAD, or PAUSE. 
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Fig. 8 — Control Module CDP18S103 block diagram. 
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Depression of the LOAD switch causes both 
WAIT-N and CLEAR-N to be asserted, defining the 
LOAD mode, in which data may be loaded into 
memory using DMA-IN. 

Depression of the RESET switch results in 
CLEAR-N asserted and WAIT-N false which puts 
the CPU into the RESET mode. 

Depression of RUN P or RUN U results in both 
. WAIT-N and CLEAR-N false, putting the CPU into 
the RUN mode. In the cast> of RUN U, the signal 
RNU-P is asserted, and goes via the backplane to the 
Address Latch and Bank Select M^kIuIg where 
memory address 8XXX is forced and starts the 
Utility program. 

When the SINGLE STEP switch is set, depression 
of RUN U or RUN P results in the RUN mode for 
one machine cycle, stopping between TP A and TPB. 
Successive depressions of a RUN switch will cause 
execution of the program, one machine cycle at a 
time. 

Inputs for external manipulation of the control 
modes are provided. EXT WAIT-P and EXT 
CLEAR-P are available on the backplane connector. 
Each is provided with a pull-down resistor and 
through one OR gate directly controls WAIT and 
CLEAR, e.g., a high on EXT WAIT-P causes a low 
on WAIT-N. 

An Idle detector circuit counts SI states to 
determine when 3 or more sequential SI states occur. 
When Idle is detected, the RUN-N line will go high 
extinguishing the RUN light on the panel. The 
operator can terminate the Idle state by depressing 
RUNP. Then a single DMAOUT request will be 
made, and following the S2 state, processing will re¬ 
sume with the instruction following the Idle. The 
RUN light will be turned on when the program starts 
running again. 

The Data Bus and Address Bus as well as WAIT- 
N, CLEAR-N, SCO-N, SCl-N and Q-P are sent to 
the display panel via Jl. Each of these lines is buf¬ 
fered . 

An interface connector J2 is provided for at¬ 
tachment of the optional Microterminal. Control 
switches from the Microterminal are electronically 
paralleled with those from the Control Panel. 


Address Latch and 
Bank Select Module 
CDP18S206 

I he Address Latch and Bank Select Module stores 
and decodes the high-order byte of the memory 
address for use by all memory modules. Fig. 9 is a 
block diagram of this module. A(7:0) from the CPU 
module is latched into an eight-bit register by TP A. 
The outputs of this register, A(15:8), are provided on 
the backplane connector and to a one-of-16 decoder. 
The decoder outputs are 16 Bank Select lines, 
BS(F:0), which go to the backplane connector. 


a[7:0J-P 



Fig. 9 - Address Latch and Bank Select Module 
CDP78S206 block diagram. 

Ihese signals break up the 65-kilobyte memory 
field into sixteen blocks of 4-kilobytes each. The 
supplied 4-kilobyte RAM module is wired to the 
lowest-order bank-select signal, BSO-P, so that it is 
located starting at address 0000. The ROM/RAM 
module is wired to BST-P locating its starting address 
at 8000. RNU, a signal derived from the RUN U 
control panel switch, causes the decoder to see A15 as 
true. Thus, after a RESET, depression of RUN U 
will cause the starting address to be 8000, which is the 
location of Utility software. 

Memory Bank De-Select (MBDS-N) is an input 
provided so that all Bank Select lines can be 
inhibited. A pull-up resistor is provided so that if no 
connection is made to this pin, the line is false, and 
the Bank Select decoder operates normally. This 
input may be used to logically disconnect the memory 
system when another is to be substituted. 
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Memory address lines A(7;0)-P are printed on the 
backplane from the CPU module to the Address 
Latch and Bank Select module and to all memory 
locations. A(12:8) address lines are printed on the 
backplane, from the Address Latch and Bank Select 
module to all memory locations. A( 15:13) are 
available at the backplane connector and may be 
wired by the user if needed. The Bank Select lines, 
BS(F:0), are available on the backplane connector 
and must be wired to appropriate memory modules to 
suit the user’s system organization. Refer to Section 
‘‘Memory Addressing and Expansion” for in- 
^ formation on adding additional memory to the CDS. 


The select lines are used as follows. Each device (or 
group of devices) is assigned a unique eight-bit code. 
When the device sees its code on the select lines, it 
responds to I/O instructions. Thus, each code in the 
select lines allows a device (or group) to use six input 
and six output instructions. The 61 and 69 codes are 
excluded because they are dedicated to the group- 
select function. 

In most systems, it will be sufficient to restrict the 
select code, by software convention, to a one-out-of- 
eight code. Then, each device need look at only one of 
the select lines. This technique allows for 48 unique 
output and 48 unique input instructions. 


I/O Decode Module 
CDP18S509 

The purpose of the I/O Decode Module is to 
provide decoded N-bit addresses for all I/O devices 
and to provide a two-level I/O addressing capability. 
Fig. 10 shows the functional block diagram of this 
module. The three N lines are decoded into 7 lines, N 
= 1 through N = 7. Because N = 0 is not a valid 
I/O operation, the zero decode is not used. 

An output port latches a byte from the Data Bus 
when instruction 61 is executed. The eight latched 
bits are provided to the backplane connector as select 
lines SELO-P through SEL7-P. The contents of the 
output port may be read, using input instruction 69, 
through the input port. 


Automatic means are provided for enabling and 
disabling two-level I/O. The control flip-flop, when 
set, enables the chip select input of the I/O ports. The 
flip-flop is set by depressing the RUNU button and 
reset by depressing the RESET button, or under 
software control (by UT20). Note that the RESET 
button will also clear the Selection Register. 

The control flip-flop can be locked out by wiring 
pin 9 of slot 13 to groimd. With pin 9 grounded two- 
level I/O is always enabled and reset. RUN P will 
start a two-level I/O program correctly. 

The select lines SEL(7:0)-P are available on the 
backplane. SELO-P is prewired to the terminal (slot 
14) and disk (slot 24) interfaces. Others can be wired 
to additional user I/O controllers as desired. For a 
further discussion of this subject, refer to “Two-Level 
I/O” under Input/Outpul Interfacing in the next 
Section. 



Fig. 10 — I/O Decode Module CDP18S509 block 
diagram. 
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ROM/RAM Module 
CDP18S401 

The primary function of the ROM/RAM Module 
is to hold the system utility software. See Fig. 11. For 
this purpose, two socketted 24-pin positions are 
provided. Each of these locations accepts either 512- 
byte or 1024-byte ROM packages. Also, these ROM 
packages may be light-erasable EPROM’s or mask- 
programmed CDP1832 or CDP1834 ROM’s. 


4-Kilobyte RAM Module 
CDP18S205 

The 4-Kilobyte RAM Module, diagrammed in Fig. 
12, provides the basic static RAM storage in the 
CDS. One module is supplied with the system, and 
memory may be expanded by adding modules in the 
memory expansion area provided. These modules are 
identical, but are assigned to the appropriate ad¬ 
dresses by a Bank Select line wired to pin X of the 
added module Tim basic RAM devices are 256 x 4 
NMOS chips. 



Fig. 11 - ROM/RAM Module CDP18S401 block 
diagram. 


Pin X of this module location is wired to signal 
BS8-P from the Address Latch or Bank Select so that 
the utility program starts at memory address 8000. 

Also on this module is a 32-byte static RAM chip 
(CDP 1824) to provide a small work area for the 
utility software. It starts at memory address 8C00. 

When the Microterminal option is installed, its 
ROM is inserted into location U8. A toggle switch 
selects either the standard utility or the Microter¬ 
minal utility ROM. When the switch is in the up 
position, the Microterminal ROM is enabled. 

Various combinations of ROM packages require 
specific link configurations. Refer to the detailed logic 
circuit and the tables of Appendix D to define the 
required link configuration for a given combination. 

The PC board is provided with pre-printed links to 
select 1024-byte ROM packages in U7 and U9 
(standard utility) and either 512 or 1024 in the 
Microterminal ROM (U8); the package types may be 
a 2708, CDP1832, or CDP1834 with the pre-printed 
links. 


BANK 
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Fig. 12 - 4-Kilobyte RAM Module CDP18S205 
block diagram. 

The address bus A(7:0)-P is buffered and wired to 
each of the 32 RAM packages. High-order address 
bits are decoded and sent to the appropriate groups of 
RAM chip-enabled inputs. 
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The data-in and data-out lines from the RAM 
packages are buffered onto the system Data Bus, 
DB(7:0), through tri-state gated buffers. The 
direction is controlled by the Memory Read signal, 
MRD-N, and all buffers are enabled when Bank 
Select is true. Thus, when the module is not selected, 
it presents a high impedance to the Data Bus, 
minimizing loading effects. 

Terminal Interface Module 
CDP18S507 

The Terminal Interface Module, in conjunction 
with serial/parallel conversion routines in the Utility 
Program, provide an ASCII interface to a bit-serial 
terminal. The module, diagrammed in Fig. 13, has 
two interfaces, logically identical but electrically 
different, for two types of serial interface electrical 
conventions. The JI connector provides a 20-mA 
current loop interface and a paper-tape reader control 
for a Teletype or similar terminal. The J2 connector 
provides an EIA interface for the Jl terminal, or 
others designed to the EIA RS232C specifications. 
Two cables supplied with the systems provide 
mechanical compatibility to either a TTY or an EIA 
interface. 


The serial ASCII characters output to the terminal 
are formed by strobing Data Bus bit 0 into a D-type 
flip-flop under control of the UT20 TYPE routines. A 
67 output instruction is used to generate the strobe. 
Bit 7 of the Data Bus is used to set the paper-tape 
reader control flip-flop and bit 6 to reset it via the 
same strobe. 

Data from the terminal is transmitted to the Utility 
program via External Flag 4. Both the strobe and 
EF4-N are conditioned by a select signal, SEL-P. 
This signal may be wired to the I/O Decode module- 
select outputs, or, if left open, a pull-up resistor 
makes the select true all the time. 

Pressing RESET on the control panel sets the data 
flip-flop and resets the paper tape control flip-flop. 
The output quiescent levels are then as follows: 

EIA - voltage low (approximately -5V) 

PT RDR - voltage low (approximately OV) 

Contact closure on the 20-mA loop incoming data 
line produces a low (true) on EF4-N. A low on the 
EIA incoming data line produces a low (true) on EF4- 
N. 
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Fig. 13 — Terminal interface Module CDP18S507 
block diagram. 
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Display Board 

The display board mounts on the hinged control- 
panel assembly. It contains six hexadecimal digit 
display units, six single LED displays, and six 
switches whose threaded bushings provide the 
method for mounting the board to the panel. 

Communication with the Control Module, by way 
of connector J1 and a flat cable, provides all logic 
,signals required. Power and groimd are supplied to 
this board by wires soldered into plated holes 
' provided. This power is always +5 volts even if the 
fest of the system is supplied from another voltage. 

Fig. 14 depicts the logic on the board. Each display 
digit is driven by a LATCH-DECODER chip which 
take 4 bits from the address, or data bus, latches them 
if required, and re-encodes them into seven segments 
for the display. The front panel hexadecimal display 
presents the characters 0 through F. 

The leftmost two digits latch the high-order 
memory address at TPA. The next two present the 
address bus continuously to provide the low-order 
address byte. 


It must be remembered that the address is always 
displayed whether or not memory is being accessed. 
In the SO state, the address is the location of data 
being fetched. In the SI state, the memory address 
may or may not be significant, depending on the 
instruction being executed. 

The rightmost two display digits show the Data 
Bus contents continuously when the control switch is 
in the BUS position. When the switch is in the LAST 
I/O position, the control module is conditioned to 
provide a latch pulse at TPB of any I/O operation. 

The six single LED’s display the state of the WAIT 
and CLEAR lines to the CPU, the state codes SCO 
and SCI from the CPU, the Q output from the CPU, 
and the system RUN state. These six displays are 
lighted when the specified condition is logically true. 

Momentary action switches provide RESET, RUN 
U, RUN P, and LOAD functions. Toggle switches 
select SINGLE STEP or CONTINUOUS mode and 
LAST I/O or BUS display. The contacts of these six 
switches are sent directly to the Control Module. 



ADDRESS BUS/LAST I/O 







LAST I/O SW-N 


- 


LD-NO 



RES-NO 

RNP-NC 

RNP-NO 

RNU-NC 

RNU-NO 


- 


SS- NO 
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Fig. 14 ~ Display board block diagram. 
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Disk Interface 
Module Option 
CDP18S813 

Slot 24 of the CDS is reserved for the optional Disk 
Interface Module. This module communicates with 
the disk drive unit through three byte I/O ports, 
bi^fers, and a 50-conductor flat cable. Its block 
diagram is given in Fig. 15. 

--The first output port, used for commands to the 
drive unit, is written to by a 65 output instruction 
with the I/O select register set to 01. Seven command 
bits are sent to the drive unit through a grounded- 
emitter open-collector transistor driver. The least 
significant bit is gated by the service request (SR) 
generated by the output port to provide a clock 
strobe. 

Data is sent to the drive unit through a second 
output port loaded by a 64 output instruction. All 
eight bits are transmitted through grounded-emitter, 
open-collector transistors. 

Data or status information from the drive unit is 
received by an input port, which is read by a 6E 
instruction. 


Microterminal Option 
CDP18S021 

Provision has been made to allow installation of the 
Microterminal and its ROM into the CDS. The 
Microterminal consists of a hand-held keyboard and 
display unit, its cable and mating connector, and a 
ROM containing a utility program UT5. A 
photograph is given in Fig. 16. 

To install the Microterminal: 

1. Turn power off. 

2. Extract the ROM/RAM module from slot 9. 

5. Install the ROM in the empty 24-pin socket 
U8. (The center of three 24-pin sockets). 

4. Re-insert the ROM/RAM module into slot 9* 

5. Insert the Microterminal cable connector into 
J2, the 20-pin connector on the outboard side of the 
Control module in slot 25. Carefully observe proper 
polarity by matching the index arrows on the 
connectors. 

6. Set the switch on the ROM/RAM module to 
its up position. 



Fig. 15 - Disk Interface Module CDP18S813 
block diagram. 
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Fig. 16 - Photograph of RCA COSMAC Microterminal 


CDP18S021. 

7. Turn power on. 

8. Press RESET, then RUN U on either the 

Microterminal or the CDS front panel. 

At this point, the display and keys on the 
Microterminal will be operative. The user should 
refer to the Instruction Manual for RCA COSMAC 
Microterminal, MPM-212, for operational details. 
Although that manual refers to the use of the 
Microterminal with the Evaluation Kit, the same 
operation considerations apply to the CDS. 

A helpful note may be added to the use of the CPU 
register readout. Follow the Microterminal Manual 
instructions, but observe that when the contents of a 
register are displayed on the CDS address displays, 
the Bus displays provide the contents of the memory 
location as addressed by the register. In other words, 
M(R(N)) is displayed. For register read-out, use the 
front panel switch RUN U for single stepping. 


To return to standard utility operation, set the 
switch on the ROM/RAM module to its down- 
position. This switching may be done while power is 
on, but if the Microterminal is to be disconnected, 
power should be turned off first. 


Power Supply Module 


The Power Supply Module consists of a trans¬ 
former, rectifers, voltage regulators, paSs stages, and 
heat sinks. The circuitry and heat sinks are mounted 
on a printed circuit board, which is mounted on the 
transformer bracket. This module is installed in the 
CDS chassis in the space beside the plug-in logic 
modules, occupying slot locations 26 through 32. See 
Appendix D, Fig. D19 for its circuit diagram. 

AC input taps are provided for nominal voltages of 
100, 115, 220, 230, and 240 volts rms, 50/60 Hz. The 
input is fused at 1.25 amperes when operated at 100 
or 115 volts. It is recommended that the fuse be 
changed to 0.75 amperes when the CDS is operated at 
220, 230, or 240 volts. Three output voltages provided 
are: +12 V at 0.5 A, +5 V at 6 A, and -5 V at 0.5 A. 

The major current drain in the CDS is due to 
memory boards. The memory board current 
requirements are given below. 


Total System with 
4-kilobyte NMOS RAM 
and 3-kilobyte PROM: 


+12 V 100 mA typical 
+5 V 1.5 mA typical 
-5 V 60 mA typical 


Total System with 
4-kilobyte SOS RAM 
and 3-kilobyte PROM: 


+12 V 100 mA typical 
+5 V 800 mA typical 
-5 V 60 mA typical 


The remaining system components are all CMOS 
and take less than 50 mA from the +5 V supply. 

Note that, typically, the CDS can support up to 12 
kilobytes of NMOS RAM. Any additional memory 
may have to be powered from an external supply. 


Development System Signals 


Table IV summarizes all of the CDS signals. For 
each signal, the source and destination modules are 


listed. The term ‘USER’ in a column designates a 
signal that may be derived from or sent to user-added 
devices. 
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TABLE IV - CDS SYSTEM SIGNALS 


Signal Name 

Description 

Source 

Destination 

A[7:01-P 

Low-order memory address 
bits 

CPU 

Memory, Address Latch 
Control 

A[15:8]-P 

High-order memory address 
bits 

Address Latch 

Memory 

ANY l/O-P 

OR'ed output from N-lines 

CPU 

Control 

BS[F;0]-P 

Memory bank select 

Address Latch 

Memory 

CDO[7:0]-N 

Data bits from disk 
interface module 

Disk interface 
module 

Disk Drive 

CLEAR-N 

CPU clear signal 

Control 

CPU, Disk 

CLEAR SW 

From Microterminal 

Microterminal 

Control 

CPU[7:0]-N 

Command bits from disk 
interface module 

Disk interface 
module 

Disk Drive 

CPU PWR 

+\/dd supply to CPU 

Power Supply/ 
User 

CPU 

DB[7:0]-P 

Bidirectional data bus 

CPU 

Memory, I/O, Control, 
Terminal 

Dl[7:0] -N 

Data bits from disk drive 
to disk interface module 

Disk Drive 

Disk interface module 

DMAI-N 

DMA IN request 

User 

CPU 

DMAO-N 

DMA OUT request 

User, Control 

CPU 

EF[4:1]-N 

Flag inputs to CPU 

I/O, Terminal, 
Control 

CPU 

EX CLK 

External clock input 

User 

CPU 

EX WAIT 

External wait to CPU 

CPU 

User 

INT-N 

Interrupt request 

User 

CPU 

LOAD SW 

From panel switch 

Panel 

Control 

MBDS-N 

Memory bank deselect 

User 

Address Latch 

MRD-N 

Memory read signal 

CPU 

Memory, I/O, Control, 

I/O Decode, Terminal 

MWR-N 

Memory write signal 

CPU 

Memory 

N[2:0l-P 

N-lines from CPU 

CPU 

I/O Decode, Control 

N=[7:1]-P 

Decoded N-lines 

I/O Decode 

I/O, Terminal, Disk, 

Control 

Q-P 

Single bit output from CPU 

CPU 

Terminal, I/O 

RESET-OP 

Reset signal from control 

Control 

Memory, I/O 

RESET SW 

From panel switch 

Panel 

Control 

RNU-P 

Signal to run utility 
program 

Control 

Address Latch, I/O Decode 

RUN-N 

Signal indicating con¬ 
tinuous S0,S1 cycles 

Control 

Display 

RUN P SW 

From panel or Micro¬ 
terminal 

Panel/Micro¬ 
terminal 

Control 

RUN U SW 

From panel switch 

Panel 

Control 

SC0[1:0]-P 

State code lines 

CPU 

I/O, Terminal, Control 

SEL[7:0]-P 

Two-level enabling signals 

I/O Decode 

I/O, Terminal, Disk 

SINGLE-STEP 

SW 

Single-step control input 

Panel 

Control 

TPA-P 

Early pulse in CPU cycle 

CPU 

Memory, Address Latch, 

I/O Decode, I/O, Control 
Terminal 

TPB-P 

Late pulse in CPU cycle 

CPU 

Memory, I/O Decode, I/O 
Control, Terminal, Disk 

UA15-N 

OR'ed output of A15 
and RNU 

Address Latch 

User 

WAIT-N 

CPU wait signal 

Control 

CPU 
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Memory Addressing 
and Expansion 


To aid the user in interfacing the COSMAC 
Development System to added memory hardware, 


this section discusses memory module addressing and 
the use of custom memory modules. 


Memory Organization 


RCA Moduies 


^The total directly addressable memory space (65, 
536 bytes) may be considered as being divided into 16 
banks of 4096 bytes each. The 16-bit memory ad¬ 
dress, A(15:0), can be divided into two fields: 
A(15:12) being a bank number and A(11:0) selecting 
the byte within a bank, (see Fig. 17). A bank may be 
further subdivided into four blocks of 1024 bytes 
each (in which case A( 11:10) is a block number within 
a bank and A(9:0) is the address of a byte within the 
selected block) or into eight blocks of 512 bytes each 
(A(ll:9) defining the block number and A(8:0) 
identifying the byte within the selected block). 

MEMORY ADDRESS BITS 

67 6 5432 I 0, 

—-^- 

4 PAGES WITHIN BLOCK 
A[9;0] 


256 BYTES = I PAGE 
A[7:0] 


2 PAGES WITHIN I HALF-BLOCK 
AL8;0] 
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Fig. 17 — Memory address bit assignments. 


^ I5 I4 I3 I2 , 
--^ 

BANK 
NUMBER 
A[ I5;I2] 



-V- 

HALF¬ 

BLOCK 

NUMBER 

ACII:9J 


Each memory plug-in module comprises a bank or 
a block of memory. When a module is inserted in a 
given plug-in slot, external wiring of appropriate pins 
on the connector in that position defines its bank and 
block numbers (the range of addresses to which it 
responds). Thus, users may define arbitrary address 
ranges for the memory modules they use. 

The COSMAC Development System CDP18S005 
is supplied with a 4-kilobyte RAM module wired to 
occupy the lowest memory address range (starting at 
address 0000). The CDS is also equipped with a 
ROM containing the Utility Program UT20. UT20’s 
address range is 8000 to 83FF. Another ROM 
containing the disk loader program occupies ad¬ 
dresses 8400 to 87FF. UT20 also uses a dedicated 
RAM of 32 bytes starting at address 8C00. Refer to 
Table III for a list of module position assignments. 


Each RCA memory module includes a sufficient 
number of enable inputs which can be used to assure 
that it will respond only over its assigned address 
range. Every module has a bank select input at pin X. 
When this signal is high, the module is ACTIVATED 
or ENABLED. When it is low, the module is 
DISABLED or DESELECTED. Whenever a 
module is added or moved in the address space, this 
overriding SELECT input must be connected to the 
proper enabling source. 

In the Development System, the supplied ROM 
memory is enabled by BS8-P, so that the UT20 
program begins at address 8000. The RAM space, on 
the other hand, is designed to begin at location zero. 
See Fig. 18 for a CDS memory map. The memory 
bank select module decodes the upper four address 
bits to provide sixteen RAM bank-select signals. The 
supplied 4-kilobyte RAM (in slot 8) is enabled at pin 
X by the lowest of these outputs, called BSO-P. 


DECIMAL ADDRESS 


HEX ADDRESS 


0-4095 

4-KILOBYTE RAM 

OOOO-OFFF 

4096-32767 

UNUSED 

I000-7FFF 

32760-33792 

UT20 

8000-03FF 

33793-348I7 

DISK LOADER 

8400-e7FF 

340I8-35839 

UNUSED 

88OO-0BFF 

35840-3587I 

REGISTER STORAGE 

0COO-8CIF 

35872-65535 

UNUSED 

0C2O-FFFF 


9ECS-29620 


Fig. 18 — CDS CDP18S005 memory map. 
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For this Manual a page is defined as 256 bytes, a 
bank as 4096 bytes, and a block as either 512, 1024, 
or 2048 bytes, as convenient. The memory bank select 
module supplies signals which can be used to locate a 
memory module in any available bank. The ap¬ 
propriate memory bank select signal (BS(F:0)-P) 
should be connected to pin X of any inserted memory 
module. If the inserted module is a 4-kilobyte 
mernory, no additional selection wiring has to be 
done. 

NOTE: Added RAM below address 8000 must 
•be contiguous for the Editor and Assembler to 
^ operate correctly. 

Reviewing the memory addressing scheme, buf¬ 
fered address bus lines from the CPU, A(7:0) are 
latched in the Address Latch and Bank Select 
module, and also wired to all memory slots. Once 
latched at TP A, the latch outputs become the high- 
order address byte, A(15:8). Of these, A(12:8) are 
pre-wired to all memory slots; A(15:13) are available 
for custom wiring, if required. A(15:12) are decoded 
into 16 Bank Select lines, BS(F:0), which are 
available for wiring to any module. 

When memory or I/O is expanded, care must be 
taken to budget power consumption to stay within the 
system’s power availability. Otherwise, additional 
power supplies may be required. Further information 
may be found under “Power Supply Module” earlier 
in this Section. 

Custom Memory Modules 

RCA will continue to offer new RAM and ROM 
memory modules designed specifically for use with 


the COSMAC Microprocessor. Users who try 
modules of their own design and construction with the 
COSMAC Development System should, of course, 
observe its physical and electronic constraints. The 
physical constraints are fairly obvious. If the memory 
is to reside in the CDS, the cards containing it should 
be no more than 6.5 inches deep and no more than 0.4 
inch in thickness over-all if adjacent slots need to be 
occupied. If the memory is to be external and serviced 
by a cable, then the cable connector may plug into a 
Memory Bus slot. This arrangement may require the 
user to buffer the address bus (A15-P to AO-P) and 
the data buses (DB7-P to DBO-P), depending on the 
length of cabling and the drive required. The memory 
must also have bidirectional I/O capability so that it 
can be hung on the data bus. If it does not, ap¬ 
propriate three-state buffers must be incorporated on 
the module. 

The COSMAC CPU architecture does not require 
memory cycles to be contiguous, i.e., to immediately 
follow each other in time. (For further information on 
memory timing refer to the material on “Memory 
Interface and Timing” in the section “Interfacing 
and System Operations” in the User Manual for the 
CDP1802 COSMAC Microprocessor, MPM-201.) 
Thus, the cycle times of added memory modules are 
generally not critical. They must, of course, be less 
than the CDS cycle time of approximately four 
microseconds. What are important, however, are the 
access and write times. The read access time in the 
CDS environment, at a clock frequency of 2.0 MHz, 
should be 0.6 microsecond maximum, and the 
memory should take no longer than that time to write. 
Slower memories may be incorporated by supplying a 
slower clock, or using a “hand-shaking” technique 
via the WAIT input of the CPU. 


Input/Output 

Interfacing 


One of the fundamental advantages of the 
COSMAC architecture is the richness of the CPU- 
I/O interface. A significant number of interfacing 
“resources” (many I/O-oriented signals, with many 
different functions) are available for use. These 
resources include the DMA and INTERRUPT 


request lines, the four EXTERNAL FLAG input 
lines, the three N output lines, the related control 
signals (CPU STATE and TP’s), and, of course, the 
I/O data bus. A wide variety of interfacing 
techniques are possible, limited only by the 
imagination of the designer. Only a few are discussed 
below, each supported by an illustrative example. 
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Module Enable Philosophy 

A fundamental interfacing feature of each of the 
RCA-supplied modules is the inclusion of at least one 
over-all “enable” input signal. Generally, this signal 
is “pulled” to the enabled state (high) by a resistor on 
the b6ard, so that if its connector pin is left alone, the 
module will be permanently enabled. This input can 
also be driven by a signal, possibly derived from a 
manual switch, so that the module can be selectively 
enabled. This feature was discussed in the previous 
. section “Memory Module Addressing”. 

The broad function of disabling an I/O-oriented 
module is to temporarily or permanently decouple it 
in some way from the I/O system. As will be 
discussed by specific examples, each I/O-oriented 
CPU input pin can be considered as the common 
destination of a set of wire-OR’ed (bussed) signal 
sources - only one of which is asserted at a time. In 
this case, the various I/O enable signals are used to 
assure that only one source at a time is coupled to the 
CPU input pin. For example, the terminal interface 
module includes an enable signal so that when it is 
disabled, EF4 is available for use by any other devices 
in the system. 

The use of such enables in the case of programmed- 
I/O data transfers is discussed in detail in the User 
Manual for the RCA CDP1802 COSMAC 
Microprocessor, MPM-201. During the execution 
of an I/O instruction, the information present on the 
three N lines of the CDS and on the eight data bus 
lines can be interpreted in any one of several ways. In 
a one-level I/O system, the N code selects one of a set 
of devices, while the data bus carries information 
between that device and memory. In this case, up to 
seven input devices and up to seven output devices are 
possible when used in conjunction with the MRD 
signal to specify the data direction. The I/O decoder 
module is used to generate an individual I/O com¬ 
mand “strobe” to activate the selected device. The 
command strobe from the I/O decoder causes it to 
put data on the I/O bus or to latch data from it. 

It should be noted that a “sub-one level” I/O 
system could be used, for a sufficiently simple system, 
in which, for example, one bit oi the N code (ap¬ 
propriately AND’ed with a TP) can act directly as a 
command strobe. For that matter, if only one I/O 
device not requiring data transfer is used, the Q 
output can be used to activate it. 

For more complex systems, a two-level I/O ap¬ 
proach is used. This approach consists of two steps; 
first enabling and then activating the selected I/O 
device. The CDS has two-level I/O capability built in 
as a user convenience. It is described in the next 
section. 


Two-Level I/O 

The I/O Decode Module in slot 13 provides seven 
lines, N = 1 through N = 7 which may be wired to the 
I/O slots to define a unique N-value address. 
Combined with the MRD signal, these signals define 
all I/O instruction codes. For example, N = 1' MRD 
defines the 69 input instruction, while N^UMRD 
defines the 61 output instruction. 

In addition, the I/O Decode module contains an 
output port that latches the Data Bus on a 61 in¬ 
struction. The latched outputs, SEL(7;0), are 
available for custom wiring to I/O slots. This feature 
is used for two level I/O addressing where more than 
seven Input/Output instructions are required. 

Suppose a module is wired to SEL2 and N=3. 
Then a 61 instruction whose data transmitted = 
(0000 0100) selects that module. A subsequent 63 or 
6B instruction would be interpreted as an output or 
input instruction intended for that module. All other 
modules are de-selected and ignore the I/O in¬ 
structions. The Select lines remain set until changed 
by another 61 or the RESET switch is activated. 

Thus, not counting the 61 and 69 instructions, a 
total of six ‘N’ lines times 8 Select lines provides 48 
unique input and 48 unique output decodes for I/O 
devices. Should more codes be required, the 8-bit 
Select register may be decoded to provide up to 255 
Select numbers. In this case, a decoder must be 
provided by the user. 

Of course, software conventions must be consistent 
with the system hardware architecture. Also, when 
using the two-level I/O addressing scheme, all I/O 
modules must be designed and wired to work with the 
selection convention chosen. 

Care must be taken when expanding the system 
I/O capability to stay within available power limits. 
Further information may be found under “Power 
Supply Module” earlier in this Section. 

The Terminal Interface module and optional 
Floppy Disk Interface module are already wired to 
SELO-P. This selection signal is automatically 
controlled by UT20 and should not, in general, be 
used by user-added I/O devices. Refer to Fig. 10 for 
the following discussion. 

The CDS is delivered with a jumper wire 
grounding TLIO-N (pin 9, slot 13). This jumper 
enables two-level I/O selection at all times. A 61 
instruction is used to latch data into the selection 
register. UT20 automatically writes a 01 to the 
selection register whenever it is started, enabling the 
terminal and floppy disk interfaces. A RESET will 
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force all zeroes into the register. Instruction 69 is used 
to read back the contents of the register for use by 
interrupt-handling subroutines. 

Users who are developing systems having one-level 
I/O should remove the jumper on TLIO. The system 
will then work as follows. A 61 instruction is used to 
enter new selection data so long as the two-level 
control flip-flop is set. This flip-flop is set when the 
RtJN U key is pressed. UT20 immediately writes a 01 
to the selection register, enabling the terminal in¬ 
terface. The flip-flop is reset by the RESET switch or 
‘by execution of the $P command, which additionally 
^ writes a 00 to the selection register. With the control 
flip-flop reset, the 61 and 69 instructions are free for 
use like any other instruction and cannot be used to 
control the selection register. 

Several operational considerations exist for the two 
options of TLIO grounded or not. These options are 
summarized below. 

With TLIO-N Grounded; 

A. RESET, RUN P Sequence 

1. Starts execution allocation 0000. 

2. Two-level I/O permanently enabled. 

3. Instructions 61 and 69 reserved for two-level 
selection. 

4. Program starts with P=X=0, IE=1, 
Selection Register=00. 

B. RESET, RUN U Sequence 

UT20 starts and runs with selection group 01 
enabled. 

SU Command 

1. Program starts at location specified. 

2. Two-level I/O permanently enabled. 

3. Instructions 61 and 69 reserved for two-level 
selection. 

4. Program starts with P = X=0, IE = 1, 
Selection Register^Ol. 

5. If an interrupt is pending at start-up, UT20 
will report it. 

Command 

1. Program starts at specified location. 

2. Two-level I/O permanently enabled. 

3. Instructions 61 and 69 reserved for two-level 
selection. 

4. Program starts with P=X0, IE = 1, 
Selection Register=00. 

5. If an interrupt is pending at start up, UT20 
will attempt to report it. 


With TLIO-N Open (High) 

A. RESET, RUN P Sequence 

1. Starts execution at location 0000. 

2. Two-level I/O is permanently disabled. 

3. All I/O instructions are available to user, 

4. Program starts with P = X=0, IE = 1, 
Selection Register=00. 

B. RESET, RUN U Sequence 

UT20 starts and runs with selection group 01 
enabled. 

SU Command 

1. Program starts at location specified. 

2. Two-level I/O enabled. 

3. Instructions 61 and 69 are reserved for two- 
level selection. 

4. Instruction 67 with data bit pattern 
(xxxxxlxx) must be avoided if two-level 
selection is to remain enabled. 

5. Program starts with P = X=0, IE=1, 
Selection Register=01. 

6. If an interrupt is pending at start-up, UT20 
will report it. 

SP Command 

1. Program starts at location specified. 

2. Two-level I/O permanently disabled. 

3. All I/O instructions are available to user. 

4. Program starts with P = X=0, IE=1, 
Selection Register=00. 

5. If an interrupt is pending at start-up, UT20 
will attempt to report it. 

6. Starting a program in this case precludes the 
use of the devices controlled by the Terminal 
and Disk Interface modules. 

NOTE: All RCA-supplied programs should be 
started with the SU command in all cases. 

Interfacing Signals and 
Custom I/O Modules 

User devices can be interfaced to the CDS with 
signals available at the I/O bus and from the I/O 
decoder. There are seven signals which are sensed by 
the CPU, namely, EFl-N, EF2-N, EF3-N, EF4-N, 
DMAIN-N, DMAOUT-N and INTERRUPT-N. 
These signals are pulled high with 22-kilohm resistors 
on the CPU board and are brought to the I/O bus. 
Control electronics for these signals should use a 
transmission gate which pulls the signal lines low 
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when activated and appears as an open circuit when 
not activated. Thus, several devices may be wire-or’d 
to these lines. 

There are eight output data lines, DBO-P to DB7- 
P, which may be connected to user devices. Data here 
is valid at TPB of the I/O execution cycle. When an 
OUT N instruction (machine code 6N, N = l-7) is 
executed, the I/O decoder sends out decoded signals 
of N = l-P through N=7-P. These signals (plus any 
of the SELO-P through SEL7-P, if desired) may be 
used to latch the data appearing on the data bus at the 
trailing edge of TPB. 

All signals in the CDS swing between GND and 
+5 volts dc. Other MOS devices such as C-, N- or 
PMOS may be added by the user (if voltage levels are 
compatible) or bipolar devices such as TTL or low- 
power Schottky TTL devices. All data and address 
bus signals as well as the CPU signals are capable of 
driving one TTL load worst-case (sinking 0.2 mA at 
0.4 volt). Open-collector devices should be used to 


drive the Data Bus, EF, DMA, or Interrupt lines, 
letting the 22-kilohm pull-up resistors on the CPU 
module generate the logic “one” voltage level. 

However, a direct interface is not recommended. A 
better practice is to buffer all signals to and from a 
user-designed module through CD4049 (inverting) or 
CD4050 (non-inverting) or CDP1856/57 buffers. 
This technique is preferable to loading the various 
busses and possibly causing problems on another 
module. Also, maintaining a CMOS interface to the 
CDS encourages the good design practice of inserting 
1-kilohm series resistors in all lines - at least initially. 
This practice will prevent accidental and costly 
destruction of components should the user-designed 
module not perform as expected. 

For a list of all signal names and their meanings, 
refer to Table IV. Note that many I/O signals are 
preassigned and should not be used indiscriminately. 
Table V lists the instructions and flags used in the 
CDS and Table VI the reserved codes for future use. 


TABLE V - PREASSIGNED I/O INSTRUCTIONS AND FLAGS 
Group 1 [00000001] - Two-level I/O enabled. 


Instruction 

Action 

61 

OUT1 

Latch MR(X) into Two-level Selection Register 

63 

OUT3 

Output Segment Data to Microterminal 

64 

OUT4 

Output Digit Data to Microterminal 

64 

OUT4 

Output to Disk Interface (Data Bits) 

65 

OUT5 

Output to Disk Interface (Control Bits) 

66 

OUT6 

Line Printer Data Out 

67 

OUT7 

Terminal Interface Serial Output Using DBO 

67 

OUT7 

Terminal Interface Paper Tape Reader Control Using DB[7:6] 

67 

OUT7 

Disable Two-level I/O when DB2 = 1 

69 

INP1 

Read Two-level Selection Register 

6E 

INP6 

Input Data Bits from Disk Interface 

6C 

l(VIP4 

Input from Microterminal 

EF4 


Serial Input from Terminal Interface 

EF3 


Keyboard Active Signal from Microterminal 

EF1 


Use for High-Speed Printer Interface Option 


TABLE VI - RESERVED I/O INSTRUCTIONS AND FLAGS 
Group 2 [00000010] - Two-level I/O enabled. 


Instruction 

Action 

61 

OUT1 

Latch MR(X) into Two-level Selection Register 

62 

OUT2 

Load UART Transmitter Holding Register 

63 

OUT3 

Load UART Control Register 

69 

INP1 

Read Selection Register 

6A 

INP2 

Read UART Receiver Hold Register 

6B 

INP3 

Read UART Status Register 
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There are typically 2 A at +5 V, 400 mA at -5 V, 
and 400 mA at +12 V reserve available from the CDS 
power supplies. This reserve should be adequate to 
handle most user-supplied additional boards. With 
series resistors in all interface lines, as recommended 
above, power sequencing should not be a concern. 

Timing diagrams for DMA requests and IN¬ 
TERRUPTS are also shown in theUser Manual for 
the CDP1802 COSMAC Microprocessor, MPM- 
201. As explained there, any DMA request or IN¬ 
TERRUPT will cause the CPU to make a transition 
'out of the IDLE state (repetitive Si’s), and cause 
program execution to start. The COSMAC CPU is 
sensitive to both DMA and INTERRUPT after 
RESET because it is in an IDLE state. Thus, 
CLEAR-N should be used to disable these external 
requests until they are required. User devices should 
not issue DMA or INTERRUPT requests until 
explicitly permitted by program or by logic, because 
initialization of CPU registers is necessary before 
INTERRUPTS and DMA’s can be handled. 

To complete this Section, the implementation of 
DMA, Interrupt, and basic serial and parallel I/O 
devices are discussed next. Reference should be made 
to the cited portions of the User Manual for the 
CDP1802 COSMAC Microprocessor, MPM-201. 


DMA Input 

Assuming only one I/O device needs the DMA 
input port, the arrangement shown in Fig. 19 is 
possible. Systems having more then one DMA 
channel (either 2 or more DMA-IN’s or a mixed 
DMA-IN and DMA-OUT) must use the Interrupt 
facility to establish vectoring. Notice that if interrupts 
will not be used in the system of Fig. 19, the SCl-P 
can be used directly for the output port and signal 
flip-flop; it does not have to be gated with SCO-P. The 
MRD-N line is also not strictly necessary unless a 
mixed DMA-IN/DMA-OUT system is being con¬ 
structed. 


DMA Output 

Assuming only one device is using the DMA- 
output channel, the circuit of Fig. 20 can be used. 
Again, note that multi-channel DMA systems must 
use the Interrupt facility. The discussion concerning 
SCl-P and MRD-N in the previous section also 
applies here. The Control Module uses DMA-OUT to 
terminate IDLE. Isolation of a user-supplies signal 
by means of a three-state device, diode, or the like is 
required on this line. 



Fig. 19 - DMA input example. 


Fig. 20 - DMA output example. 
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Byte I/O 

A general purpose Byte I/O Module designed for 
use in the CDS is shown in Fig. 21. By appropriate 
connection of the module’s enabling signals to the ‘N’ 
lines and SELECT bits from the I/O Decoder, the 
modple can be assigned to respond to any 
programmed I/O instruction. The module could be 
permanently enabled (by leaving the Select input 
open) or permanently disabled (by grounding the 
Select input), if desired. 


The source of an asynchronous interrupt must be 
deduced from externally generated information, such 
as the contents of an interrupt status register (in¬ 
terrogated by an I/O READ instruction), any exter¬ 
nal flag values, or the address of register RO as 
dictated by DMA activity. The CPU contains a 
programmable INTERRUPT ENABLE (IE) bit. Its 
operation is discussed in detail in the User Manual 
for the CDP1802 COSMAC Microprocessor, 
MPM-201. Before designing an interrupt-generating 
I/O circuit for installation in the CDS, the reader 


■•■Vdd 



Fig. 21 - General-purpose byte I/O module 
for the CDS CDP18S005. 


Interrupt 

A straightforward interrupt implementation is 
shown in the User Manual for the CDP1802 
COSMAC Microprocessor, MPM-201. 

Systems which require multiple interrupt 
conditions can be handled in a variety of ways. If the 
interrupts are synchronous with respect to each other 
(i.e., there is a prior knowledge that there will be a 
specific patterns such as ABAB....or AAB- 
CAABCA....), then all the handling can be ac¬ 
complished with software. The interrupt analysis 
pointer is merely re-initialized after each service to the 
address necessary to handle the next service. 


should refer to the material on “Interrupt and 
Subroutine Handling’ ’ in the Instruction 
Repertoire Section and the material on “Interrupt 
Service” in the Programming Techniques Section 
of the User Manual, MPM-201. 


Fig. 22 shows a general purpose interface to the 
CDS for multiple interrupts. The interrupt routine 
would issue a specific input instruction (say ‘62’) and 
the device requesting the interrupt would put its 
address on the data bus where it can be examined by 
the CPU and used to vector to the right routine. 
Additional hardware would be required if the 
possibility of simultaneous interrupts exist. 
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INTERRUPTING 

DEVICE 

ADDRESS 



Fig. 22 — General-purpose circuit for vectored interrupts. 


A good programming technique is to put the 
bytes 71 and 00 as the first two instructions in your 
program. That will disable interrupts until you are 
ready for them. At that time, they can be re-enabled 
by setting X=P, then performing the instruction 
sequence 70, (X,P) where the byte after 70 contains 
the initial values for X and P. Refer to the User 
Manual MPM-201 for interrupt servicing program 
techniques. 

Bit Serial Interface - The Terminal 
Interface Module 


The flexibility obtainable with software is 
demonstrated by the ability of the program UT20 to 
sample a character string and adjust its timing so as to 
cope with terminals of different, even non-standard, 

jiruu 

w w rororororo nro www 

> -I HHHHH HH 00> 

31 O ->K)C0ACJ1 Ol-vJ *D-Oj] 

H H 

t— (OPTIONAL ON 
SOME DEVICES^ 

BIT SERIAL 

ASCII CHARACTER "C" (41) 

92CS-2e086 


The Terminal Interface Module is the only 
custom input/output interface supplied with the 
COSMAC Development System. It is another 
example of minimizing hardware complexity by the 
use of software. Further, it illustrates the increased 
flexibility that can more readily be achieved by 
software. A functional diagram for this module (Fig. 
13) has already been discussed. The CPU receives 
serial data by sampling EF4. It transmits serial data 
via bit 0 of the data bus in conjunction with an output 
instruction, specifically 67. The detailed logic for the 
Terminal Interface Module is shown in Appendix D. 


Fig. 23 — Sample character waveform. 

character rates. However, it should be noted that 
while a program is timing either input or output in 
this manner (i.e., by counting instruction executions), 
the processor is completely dedicated to that task. 

Interfacing Techniques 
and Precautions 


The sample character waveform in Fig. 23 helps 
to show what the interface software must do. Each 
character is framed by a START bit and one or two 
STOP bits. The character waveform signal is tied to 
EF4-N, sensed by UT20 at the midpoints of each of 
the bits, and assembled into the ASCII character. A 
character is transmitted one bit at a time with bit 0 of 
the data bus latched by a D flip-flop. The Q flip-flop 
can also be programmed to provide serial output 
data. 


Use of External Clock 

Procedme: Remove the crystal on the CPU 
board. Connect pin Pl-12, slot 12 (EX CLK) to the 
clock generator. The external clock signal should 
swing between +5 volts and GND with rise and fall 
time equal to or less that 15 microseconds. Because 
the COSMAC CPU is a static system, single-stepping 
(single clock cycles) or steps in bursts of 8 or 16 clock 
cycles, for example, are possible. 
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Clock frequencies higher than the standard 2.0 
MHz may be employed in some cases. The 
COS/MOS interfaces supplied with the CDS (at 
Vj)j) = 5 volts) will not operate above about 3 MHz 
because of the short timing pulses. At frequencies 
lower than 2.0 MHz, the utility program will 
eventually fail to time the terminal serial characters 
properly because of quantizing effects. The frequency 
at which these effects occur is a function of the ter¬ 
minal character rate. 


External Flags EF1 to EF4 

The external flags offer a simple, yet powerful, 
input interface to the COSMAC CPU. Means by 
which a program may test an external flag and branch 
conditionally on its value have already been 
discussed. The use of a flag as a bit-serial data input 
port was also described. Note that, with the terminal 
interface module in its slot, EF4 is unavailable for 
other devices unless the I/O data terminal-to-EF4 
patch is disabled, by forcing SEL-P low. Because 
transmission gate outputs may J>e connected as “wire- 
ors”, several devices may share a specific External 
Flag signal, when necessary. This arrangement is 
illustrated in the logic of the terminal interface 
module. It should be recalled that all four EF’s are 
pulled up to Vp)£) through 22-kilohm resistors on the 
CPU module. 

In order for an external flag to play a functional 
role in a COSMAC-based system, it must be tested by 
the program at the time when action is required. 
Further, in programs which incorporate a periodic 
flag test, there must be some means for the interface 
logic to sense that the flag stimulus has caused a 
resfK)nse. In system where it is necessary to detect 
failure or error conditions, one or more flags may be 
used. If immediate action is required, the flags may 
be used as a means to vector interrupts. 


Adding I/O Devices 

When additional I/O is added to the CDS, it is 
most important to remember that certain I/O in¬ 
structions and group selection codes are already 
assigned to specific CDS modules. These codes are 
detailed in Tables V and VI. Care must be taken not 
to overlap them. I/O can also be added in the 
memory field of the CPU for memory-mapped I/O 
functions. In that case, be sure to refer to the memory 
map, Fig. 18, to determine free memory locations. 


Adding Remote Control 

Along with the DMA, Interrupt, and Flag lines, 
the CLEAR and WAIT lines of the CPU are brought 
out to the backplane. These lines are labeled EXT 
CLEAR-P (Pl-11) and EXT WAIT-P (PM2), 
respectively, from the Control Module. The EXT 
CLEAR-P line will not reset the entire CDS system, 
but only perform the appropriate CPU functions. 

The RESET, RUN U, and RUN P signal lines 
are also available on the J2 connector of the Control 
Module. Refer to Appendix D for pin numbers. 
These connections normally go to the Microterminal, 
but can also be used for other remote control inputs. 

Development System 
Dynamic Characteristics 

COSMAC CPU timing and dynamic 
specifications are to be found in the User Manual for 
the CDP1802 COSMAC Microprocessor, MPM- 
201, and in the data sheet for the CDP1802. 
COSM AC-based products should be designed to 
those specifications. The CDS interface is designed to 
facdlitate functional experiments. ^Phe interface 
supply voltage, Vpp, of +5 volts, the modular 
construction, and the consequent capacitive loading 
make it a slower system than that which can be 
supported by the COSMAC CPU itself. 

The signals of shortest duration in the CDS are 
TPA-P and TPB-P. The TPB timing signals occur 
late in a machine cycle to indicate that the data 
present on the bus (from a memory access) is valid. 
The earlier timing pulse, TPA may also be used when 
a general purpose strobe is required. 

Memory timing requirements for user-added 
memory have been given earlier in this Manual under 
Memory Addressing and Expansion. 


Troubleshooting 

After the Development System is plugged in and 
POWER switch turned on, the display lights should 
come on. 

Depressing RESET should cause the RUN in¬ 
dicator to turn off. If it does not, noise or extraneous 
signals may be present on any of the DMA-OUT, 
DMA-IN, or INTERRUPT lines. 
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Depressing RUN U should cause the RUN in¬ 
dicator to light. If it does not, the problem may be a 
failure in the control module, no CLOCK signal, a 
burned-out indicator, or a failed CPU. 

Another common problem is data bus contention 
caused by enabling user-inserted I/O devices or 
memory onto the data bus at the wrong time. In 
particular, if extra memory modules have been ad¬ 
ded, check that they are wired to the correct Memory 
Bank Select signal. 


So long as CLOCK and dc power (Vj)d and 
CPUPWR) are present at the CPU module, then 
TPA and TPB should also be present unless CLEAR- 
N or WAIT-N is asserted. 

Pressing LF or CR after RUNU should cause 
UT20 to calibrate itself and type out a prompting 
asterisk. If the CDS does not respond to UT20 
commands, then locating the source of trouble is 
beyond the scope of this Manual. In particular, the 
troubleshooting of user-designed interfaces is an art. 


Hardware Specifications 


NEST 

19” rack mount, 5.25” high, 10” deep. 

32 card positions (7 occupied by power supply). 
Connectors with plastic guides. • 

44 pins; 0.156” pin spacing; wire-wrap pins 
0.5”'connector spacing 


PANEL 

Hinged at left; knob provided to latch paneL 

Seven switches 

POWER ON 

RESET 

RUNP 

RUNU 

LOAD 

SINGLE STEP or CONTINUOUS 
BUS or LAST I/O BYTE DISPLAY 

Six Hex Digit Displays for MEM ADD and 
BUS/I/O 

Six LED Indicators: 

RUN 

Q 

SCO 

SCI 

WAIT 

CLEAR 

Line cord and socket at back of cage. 


POWER SUPPLY 

Mounted to slotted rear of nest, uses space of 7 
connectors. 

+5 volts at 6.0 amperes; 5% regulation 
-5 volts at 0.5 ampere; 5% regulation 
+ 12 volts at 0.5 ampere; 5% regulation 
Short circuit and thermal protection. 

One fuse for AC, on front panel. 

(no overvoltage protection) 


CABLING 

AC power cord (8 feet) 

Power supply to Panel: 

+ 5 volts for lamp, ground 

Power to control module connector: 

Flat cable, 50-pin for interfacing display logic 
and control switches 

Terminal module to (customer furnished) TTY: 

Six-wire cable (15 feet) 

terminated with MOLEX connectors for TTY 

Cable from terminal module to terminal using EIA 
interface: 

15 feet of six-wire cable to 25-pin Cinch plug. 


• These connections have unusual sized pins— .015 " x ,041”. For wiring, equipment such as OK Machine (Bronx, N.Y.) 
electric-powered wire-wrapping tool Model EW 7D or Model G-lOO with bit WB2644M and sleeve P3032LN, or equiva¬ 
lent, should be used. Cards inserted in these connectors should have beveled edges to avoid deforming the contacts. 
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CDS Resident Software 
Development Aids 


A resident software aid is a program which runs on 
the RCA COSMAC Development System, is stored in 
or loaded into one of the system’s memories, and 
performs some general function for the user. The 
Utility Program UT20, for example, is a permanently 
resident software aid. A program is permanently 
resident when it is stored in ROM, occupying some 
fixed portion of the addressable memory space. It is 
temporarily resident when it is loaded into some 
portion of the existing RAM space. One of the 
fundamental purposes of UT20 is to facilitate this 
loading process. 

In this section of this Manual, two resident soft¬ 
ware aids are described. These aids are the COSMAC 
Resident Assembler and the COSMAC Resident 
Editor. The COSMAC Resident Assembler trans¬ 
lates a program in assembly language into 
hexadecimal code ready for machine operation. The 
COSMAC Resident Editor is a programming tool 
that helps in program creation, correction, and 
change. It operates interactively with the user at a 
terminal. This section will provide some useful in¬ 
troductory material that applies specifically to the 
Assembler and the Editor programs. 

CDS I/O Terminals 

Both the Assembler and the Editor programs 
process an input or source file and produce an output 
file. For purposes of this Manual, a file may be 
considered to be a sequence of records or lines (each 
consisting of a sequence of characters) stored in some 
storage medium. The program reads the input file, 
processes it in some way, and writes an output file. 

Three versions of the Resident Assembler and 
Editor are available for use with the CDS. One is a 
paper-tape version of both programs for use with a 
Teletype (TTY) terminal. The second is a magnetic 
cartridge version supplied for the Texas Instrument 
“Silent 700” terminal or equivalent. In this manual. 


the TI Model 733 ASR with “Remote Device 
Control” option is assumed. A third version of the 
resident software is supplied on a diskette to pur¬ 
chasers of the CDS Floppy Disk option (CD- 
P18S805). With this option, any standard data 
terminal can be used that will interface to the CDS 
i.e., having a serial ASCII 20-mA or RS232 interface 
with a baud rate of 110, 300 or 1200 baud. The 
Floppy Disk Manaul MPM-217 describes the use of 
the resident software on that system. The discussion 
in this manual concerns only the paper tape and 
magnetic cartridge versions. If a Teletype terminal is 
used (with local files on paper tape), it must be ad¬ 
ditionally outfitted with a Remote Reader Control 
feature (see Appendix C) to permit the running 
program to start and stop the paper-tape reader. 

While the resident program runs, the terminal 
device (Teletype or TI terminal) should operate in the 
line mode, with media (paper tapes or magnetic tape 
cassettes) properly mounted and with the manual 
media control switches properly set. As before, the 
terminals are to be in the full duplex mode and set 
for the appropriate baud rate. 

Memory 

Space Requirements 

In addition to the memory area occupied by the 
resident program, RAM “work” space is normally 
required. This work space can be used for many 
purposes. For example, typically it contains an input 
buffer area into which one or more input lines are 
read from the source file. An output buffer may also 
be included into which data is accumulated prior to 
writing to the output file. Space may also be required 
to build data tables whose contents depend on in¬ 
formation in the input file. 

The COSMAC Resident Assembler and Editor are 
read-only programs, i.e., any memory writes which 
take place during execution occur in the work space. 
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The program itself resides on some input file (paper 
tape or magnetic tape cassette), and is loaded into 
RAM by use of standard UT20 loading techniques 
previously described (the “!M” command). Once the 
program is loaded, control is transferred to it, again 
by the standard UT20 command $U(CR). Once it is 
in control (running), it proceeds to communicate with 
the user via the I/O terminal, outputting its own 
prompt messages on the printer, reading user 
commands from the keyboard, and appropriately 
processing the input file to generate an output file. 


In subsequent operating instructions for the 
Assembler or the Editor, program space requirements 
and the minimum amount of work space required 
(RAM) are defined. If more RAM space is available, 
the program is designed to take advantage of it by 
providing some form of “belter" service las explained 
further later). Both programs load starting at address 
0000 and thus cannot be resident simultaneously in 
the CDS. 


Informal Introduction 
to the COSMAC 
Resident Assembler 


Early in this Manual under the head “Machine 
Language Programming,” a simple time-out test 
program was discussed. This program in UT20- 
compatlble hexadecimal load form is given by: 


Flow Chart to Operation 
Mnemonics 


!M0 F8FFB1219191913A030Q (CR) 

This program was generated using the following flow 
chart: 


The time-out text program given above can be used 
to illustrate some of the essential properties of the 
COSMAC Resident Assembler starting from the flow 
chart and proceeding toward the hex form “bv 
hand.” 


ENTRY 
4 ' 

INITIALIZE A DOWN COUNTER 
WITH A VALUE n 
4 ' 

r^DECREMENT THE DOWN COUNTER 
4' 

DUMMY NOP INSTRUCTIONS 
(IF DESIRED) TO PROVIDE 
SOME TIME DELAY 

HAS COUNTER REACHED ZERO YET7 
4- v(r 

-NO YES 

4 ^ 

EXIT 


A next version of the program, expressed in terms 
of specific COSMAC instructions, is shown below: 

ENTRY 

LOAD D WITH AN IMMEDIATE ARGUMENT ni6 
PUT D INTO THE UPPER HALF OF SOME 
COUNTER GENERAL REGISTER. 

I 

-^ DECREMENT THE COUNTER 


This flow chart, of course, is a much more un¬ 
derstandable version of the program. The time from 
ENTRY to EXIT is approximately nj 5 times the 
time for one pass through the loop. 

An assembly lan^age is designed to permit a 
machine-readable form of a program whose content is 
intermediate between that of an English language 
flow chart, which is easily understood, and that of a 
machine language hexadecimal string, which is 
essentially impossible to “read”. A proper assembly 
language program, containing mostly English-like 
text, can be directly “read” and understood. An 
assembler is a program which converts the assembly 
language version into its equivalent machine language 
form. 


I 

ANY DUMMY TIME DELAY INSTRUCTION 
(IF DESIRED) 


ANY DUMMY TIME DELAY INSTRUCTION 
(IF DESIRED) 


PUT UPPER HALF OF THE COUNTER INTO D 


BRANCH BACK TO-i IF D iS NOT YET ZERO 




HERE 


THIS IS THE EXIT. (THE NEXT INSTRUCTION 
EXECUTED WHEN THE COUNTER HAS 
REACHED ZERO) 
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The use of short hand mnemonics for the in¬ 
structions and appending comments gives: 


Two examples are given below: 

Example 1) LABEL: DEC COUNTER 


LDIn 

,PHI COUNTER 


_ n IS APPROXIMATELY THE 
..NUMBER 

. . OF 256 LOOP PASSES BELOW 


BNZ LABEL 


r-^DEC COUNTER . . REDUCE NUMBER OF PASSES 
- * .^REMAINING 

DUMMY . . JUST TO WASTE TIME 

DUMMY .. WASTE MORE TIME 

GHI COUNTER . , SEE IF COUNT HAS YET 
*,REACHED 

BNZ —I .. ZERO. LOOP IF NOT 

-HERE 

EXIT INSTR . . TIME EXPIRED. GO ON 

where LDI, PHI, DEC, GHI, and BNZ are 
operation mnemonics standing for LOAD IM¬ 
MEDIATE, PUT HIGH, DECREMENT, GET 
HIGH, and BRANCH IF NOT ZERO, respectively. 
Their equivalent hexadecimal codes (for example, 3A 
for BNZ) can be found in Appendix E and in the 
User Manual for the RCA CDP1802 COSMAC 
Microprocessor, MPM-201. Each line is now 
beginning to resemble an assembly language 
statement. 

The last version illustrates two fundamental 
properties of an assembly language - the use of 
operation mnemonics and the use of comments. An 
assembler is designed to recognize operation 
mnemonics, which are much more descriptive to the 
programmer, and to convert them into their hex¬ 
adecimal code equivalents. In addition, an assembler 
is designed to ignore comment text fields in 
statements when it recognizes their existence. In the 
program version above, every comment begins with a 
double period (..) and extends to the end of the line. 
Comments are invaluable to the programmer because 
they permit him to add documentation to a program s 
statements. 


Addressing 


The next problem considered is that of assigning 
addresses - specifically, the branch address in the 
last instruction in the loop. Clearly, addresses which 
are assigned depend on where the program will reside 
in memory while it is executing. If it is assumed that 
this location is not presently known absolutely (for 
example, because the routine’s exact location within a 
larger program may change), a labelling procedure 
may be defined to replace the arrowed path shown. 


An assembler permits locations within a program to 
be identified by English-like symbols (e.g., 
“LABEL:” above). Then any reference to a location 
may be made by use of its label (e.g., “BNZ 
LABEL”). The programmer is free to select almost 
any sequence of up to 6 characters for each label. 
Typically, he chooses a symbol which has some 
logical meaning within the context of his program 
(e.g., LOOP, DELAY, TESTl, SEARCH, etc.). 
During the process of translating the program’s 
statements, the assembler keeps track of the ad¬ 
dresses of all bytes it generates (starting from some 
known address reference, such as zero). It uses an 
internal location counter for this purpose. Whenever 
it encounters a LABELed statement, it enters the 
address of the instruction in a symbol table. All 
references to that label may then be replaced with 
appropriate address bytes. 

Example 2) BNZ *-m 

An assembler also normally permits addressing 
relative to the position at which the reference is 
found. The special symbol is meant to refer to the 
address of this statement and m is a count of the 
number of bytes from this point. 

Two forms of symbolic addressing have been 
defined: using a statement label or using the symbol 
One form of the program now becomes: 


BEGIN; LD!n 

PHI COUNT 
LOOP: DEC COUNT 

DUMMY 
DUMMY 
GHI COUNT 
BNZ LOOP 
EXIT: IDE 


. . n IS APPROXIMATELY THE 
..NUMBER 

, . OF 256 LOOP PASSES BELOW 

. . REDUCE NUMBER OF 
. . PASSES REMAINING 

. JUST TO WASTE TIME 
. . WASTE MORE TIME 
. , SEE IF COUNT HAS REACHED 
. . ZERO. LOOP IF NOT 
. . STOP AFTER TIME DELAY 
, , HAS EXPIRED 


which is almost a correct assembly language program. 
(Notice that three statement labels have been 
specified. Only one is presently referenced). 
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Assembly Language 
Equivalent 

Next to be discussed are the selection of the value 
for n, the selection of the COUNT register, and the 
“DUMMY” instruction. To get the maximum delay, 
the original version of this program used a hex FF for 
the immediate byte. The assembly language 
statement LDI #FF will translate properly. This 
selection provides an example of the fact that there 
" are still many places in a program where explicit 
^ values are specified by the programmer. The 

indicates the presence of an explicit hex constant. One 
can similarly explicitly identify the general register to 
be used as the counter with statements such as PHI 1, 
DEC 1, etc., assuming R1 was chosen. Suppose, 
however, that one wished to defer or later modify 
register assignments. A convenient permissible 
procedtue is to continue to use the symbol as an 
identifier (in this case not of a memory location but of 
a general register) and to give the symbol a value with 
a special statement called an EQUATE statement, 
which has the form COUNT=l. In this case, all 
occurrences of COUNT will be replaced with 1 by the 
assembler. If, later, one wished'to reassign registers, 
a change to COUNT=10, for example, would 
automatically change all references to COUNT to hex 
value ^OA. 


precede many kinds of “constants”, some whose 
values are explicitly stated and some whose values are 
derived by the assembler. In particular, the statement 
“DUMMY”, for example, will cause a substitution of 
the value for the symbol. Thus, if another statement 
DUMMY=^91 is supplied, a means is again 
provided by which all occurrences of DUMMY will 
be replaced by a hex 91 (which is a GHI 1 in¬ 
struction). 

Finally, the assembler begins assigning address 
values starting with zero. A special' statement is 
provided to cause the assembler to change the present 
value in its internal location counter if required. It is 
called an ORG statement. The final form of one 
assembly language equivalent of the hex program 
started with is then: 


BEGIN: 

LDI #FF 

, .INITIALIZE COUNTER 
. .REGISTER FOR 


PHI COUNT 

. .ABOUT 65000 PASSES. 

LOOP: 

DEC COUNT 

. .REDUCE#PASSES 
, .REMAINING BY 1. 


,DUMMY 

. .JUST TO WASTE TIME. 


,DUMMY 

. .WASTE MORE TIME. 


GHI COUNT 

, .SEE IF COUNT HAS 
. .YET REACHED 


BNZ LOOP 

. .ZERO. LOOP IF NOT. 


To generate a delay, one may use the NOP in¬ 
struction or any other time-wasting instruction. The 
hex program originally given merely repeated the 
GHI 1 instruction three times. There are several ways 
by which this instruction can be expressed to the 
assembler. One in particular uses another form of 
EQUATE statement to give a value to a symbol. As 
will be explained later, a comma may be used to 


EXIT: IDL , .STOP AFTER TIME DELAY 

. .HAS EXPIRED 

COUNT - 1 . .REGISTER 1 ASSIGNED AS 

. .THE COUNTER 

DUMMY-#91 . NOP IS A REPEAT OF A 
. ,GHI I INSTRUCTION. 

END . .REQUIRED LAST STATE- 

, .MENT IN EVERY PROGRAM. 


COSMAC Resident Assembler 


Assembler Operation 

The COSMAC Resident Assembler (CRA) is a 
program which provides for assembly of COSMAC 
programs without the use of another computer. CRA 
runs directly on the COSMAC Development System 
itself in a stand-alone manner. It converts source 
programs written in COSMAC Level I Assembly 
Language into executable (hexadecimal) machine 
code. 

The use of an assembler permits the programmer to 
write programs using convenient symbols and ex¬ 
pressions, The input or source program consists of a 
sequence of statements. A statement is normally 


translated by the assembler into an equivalent 
sequence of hexadecimal digits (a single machine 
instruction or a data field of user-defined constants). 
This code is then placed in its proper position (i.e., 
assembled) in an output or object file - which is the 
executable machine program. Some statements are 
special control commands to the assembler. They are 
called assembler directives. They are distinguished 
by the fact that they do not directly cause output code 
to be produced. 

An assembly language program (as compared to its 
machine code counterpart) is easier to write and to 
understand. Each statement may be annotated with 
user comments which are ignored by the assembler 
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but carried along for documentation purposes. The 
assembly language program is easier to change and 
contributes to fewer trivial errors than a 
corresponding machine code program. 

The Location Counter 


Th^ basic function of CRA is to fill a simulated 
COSMAC memory (the object code area or file) with 
the hexadecimal equivalent of the user’s source 
program. For this purpose, CRA maintains a two- 
byte location coxmter as a pointer into this area. The 
ihitial value of the location counter is zero. As CRA 
hins and produces output code, it places this code in 
the output area at the position specified by the 
location coxmter, and then advances the location 
counter past the bytes just inserted. The value of the 
location counter is also controlled by the CRA 
directive statements ORG and PAGE (explained 
later). These statements may be used, for example, to 
advance the location counter past an area without 
filling it. 

The source programmer may explicitly refer to the 
current location counter value by use of the character 
in an expression (see later discussion). 

The Symbol Table 

The most fundamental logical facility provided by 
an assembler to aid in the output code generating 
process is its ability to construct and reference a 
symbol table. A symbol is a sequence of one to six 
alphanumeric characters beginning with a letter.. 
Each programmer-defined symbol is given an entry in 
this table where it is assigned a two-byte value which 
is often an address value equal to the location counter 
contents at the point where the symbol is “defined” in 
the program. However, it may also be a user-specitied 
value (for example, a constant) if the symbol is 
defined in an EQUATE directive (explained later). 
Thus, while a symbol most often represents an ad¬ 
dress, it may also represent a specific CPU register, 
an I/O device number, or any other user-specified 
value (e.g., a constant, an immediate argument, etc.). 


Expression Evaluation 

As CRA processes source statements, it produces 
hexadecimal code values. Much of this code is the 
direct equivalent of explicit, user-specified in¬ 
formation in the source program (constants, register 
or device numbers, operation code mnemonics). 
Other code values are derived indirectly, using either 
the current value in the location coxmter or the value 
assigned to a specific symbol in the symbol table. The 
code values thus produced are either assembled into 
the output stream, as previously described, or 
assigned to new symbol table entries (when new 
symbols are defined). 

At various places in the source program, CRA will 
be expecting to encoxmter an expression. An ex¬ 
pression is defined as one of the following forms: 


1) expression constant 

2) * 

3) *±expression constant 

4) symbol 

5) symbol ± expression constant 


#2F or 47 

H: 

*+47 or *-#Fl 
SAM or J65MP 
AREA9-#2F 


where an expression constant contains an explicit 
hexadecimal or decimal value. (The acceptable forms 
for expression constants are described later.) CRA 
evaluates the expression by using the explicit constant 
value (if present), the cxxrrent location coxmter value 
(for the if it is present), the symbol’s value in the 
symbol table (if a symbol is present), and by per¬ 
forming the required arithmetic operation (if 
necessary). The result is always a two-byte value 
which may be disposed of in any one of several ways, 
as discussed further later. Spaces adjacent to the + or 
- operators are optional. 

Following is a more detailed definition of the 
syntax which CRA is designed to recognize. 


COSMAC Level I 
Assembly Language 

Lines and Comments ^ 


A symbol normally appears at many points in the 
source program. At one of these points, it is assigned 
a value in the symbol table; i.e., it is defined. At all 
other points (whenever the symbol is referenced), this 
value is xised by the assembler to derive or produce 
code. Thus, by changing the value assigned to a single 
symbol, the programmer can make substantial 
changes in his object code file. 

A symbol is also called a label, a name, an iden¬ 
tifier, or a symbolic address or pointer. 


Each line or record in the source file is 
distinguished by an ending carriage return character. 
A line may consist only of a comment or of one or 
more statements optionally followed by a comment. 

^ NOTE: All discussion regarding special CRA punctuation char¬ 
acters (such as semicolon, colon, period, asterisk, parenthesis, 
equals sign, number sign, apostrophe, etc.) refer to those which 
do not appear within text constants (defined later). Any char¬ 
acter within a text constant has no special punctuation signifi¬ 
cance to CRA. 
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A comment is any series of characters begin¬ 
ning with two periods. It extends to the end of the 
line. Thus, the occurrence of two periods at any point 
in a line causes CRA to ignore the remainder of the 
line. Statements within a line are normally separated 
by semicolons (with the last statement optionally 
terminated by a semicolon). Within each statement, 
spaces (blanks) may be used freely (except within 
symbolics and mnemonics) in order to improve 
readability. CRA will ignore them. 

In all the examples which follow, a pair of square 
brackets will be used to enclose an optional entity - 
one which may or may not be included. Examples of 
valid lines are then: 

1) ..COMMENT 

2) STATEMENTi [;STATEMENT2 ; 

STATEMENTn] [;] [..COMMENT] 

Symbol Definitions 

(Statement Labels and Equate Statements) 

Any statement may optionally begin with a 
symbol (called a “statement label’’) immediately 
followed by a colon. Under these conditions, the 
symbol is entered into the symbol table and assigned 
the present location counter value. A statement thus 
has the form: 

[SYMBOL:] STATEMENT BODY 
(For example, LOOP: INC R4) 

A symbol is also defined when it appears as the left- 
hand part of an EQUATE statement, which has the 
form: 

SYMBOL=EXPRESSION 

(For example, READER=6) 

In this case, the expression is evaluated and the 
resulting two-byte value is assigned to the symbol in 
the symbol table. (Acceptable forms for symbols and 
expressions have already been explained.) 

Thus, a symbol definition is indicated to CRA by 
the occurrence of or “ = ” immediately after a 
leading sequence of alphanumeric characters in a 
statement. 

When equating a symbol to a register number, only 
a decimal or a hexadecimal number should appear on 
the right side of the equation. For example: 


COUNTR=7is correct 
COUNTR= ^07 is correct 
COUNTR= R7 is incorrect 

DELAY= COUNTR is also correct 

Explicit Constants 

At numerous points in the source program, the 
programmer desires to directly Specify explicit 
constants to CRA. Most often (but not always) the 
hexadecimal equivalent of an explicit constant is 
inserted directly into the output code stream at the 
point where it appears in the source program, (For 
example, initial data values and immediate 
argiunents may be explicitly defined this way.) CRA 
allows the programmer the ability to specify absolute 
constants in binary, hexadecimal, decimal, and 
alphanumeric forms. The possible explicit constants 
are summarized below. 

Hexadecimal constants: A hex constant is specified 
with either of the following forms: 

Example 

1) #hh...hh #3E0F 

2) X‘hh..hh’ X‘3E0F’ 

where each h is a hex digit (0 to F). CRA requires 
that an even number of hex digits be specified. 
There are further restrictions on hex constant lengths 
under certain conditions. 

Decimal constants: A decimal constant is specified 
with either of the following forms: 

Example 

1) dd...dd 635 

2) F‘dd...dd’ D‘635’ 

where each d is a decimal digit (0 to 9). Each such 
constant is converted into hex, producing one or two 
bytes, depending on the space required to represent 
it. Decimal values greater than 65535 are converted to 
hex but then truncated to two bytes (upper bytes 
removed). 

Expression constants: An expression constant may 
be either form of the hex constant or the first form of 
the decimal constant. Because an expression tran¬ 
slates to two bytes, a hex expression constant should 
normally be restricted to two or four digits in length. 
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Binary constants: A binary constant is specified in 
the form: 

B‘bb...bb’ 

(For example, B‘01101’) 

where^ each b is 0 or 1. Up to eight bits may be 
specified. Each such constant is converted to one 
byte, with leading O’s assumed. 

Text constants: A text constant is specified using the 
'form: 

T‘cc...cc’ 

(For example, TTHIS IS TEXT’) 

where each c is any printable character, including 
space. Each character is converted to its ASCII code 
equivalent (see Appendix F) and is represented in one 
byte. Characters that have no graphic associated with 
them (i.e., ETX, DC-3, CR, LF, etc) should not be 
used within a text constant. Entering an apostrophe 
within a text constant is treated specially, however. 
See “Additional Notes” below. Refer to Example 4 
under “Examples of UT20 Read and Type Usage” to 
see how CR, LF is handled. 


Address Constants 

The programmer finds it useful to specify not 
only explicit or absolute constants, but also derived 
constants whose values are assigned or “computed” 
by the assembler. Because the fundamental function 
of the assembler is to assign address values, such 
constants are normally called address constants. For 
CRA, an address constant has one of the following 
forms: 

Example: 

1) A(expression) A(GEORGE + 2) 

2) A. 1 (expression) A.I(LOOP) 

3) A.O(expression) A.0(*-X‘10’) 

where the permissible forms for an expression have 
already been defined. For all cases, the resulting 
constant is derived by first evaluating the expression. 
In the first case, the two-byte result is the constant. In 
the second case, only the upper byte is used; for the 
third case, only the lower byte. For all cases, the 
resulting one- or two-byte value is assembled directly 
into the code output. 


Operation Mnemonics 

CRA uses special two-, three-, and four- 
character mnemonics to represent the various in¬ 
structions in the COSMAC instruction set. These 
mnemonics are listed in Appendix E. When CRA 
determines that an operation is being specified, it 
looks it up in a table to determine the code equivalent 
of the mnemonic. (Note that this table is not the 
syrnbol table, which contains only programmer- 
defined symbols.) Thus, use of an operation 
mnemonic effectively defines an explicit hex code 
value to be inserted into the object stream. 

Instructions and Operands 

There are two types of output code-producing 
statements: instructions and data lists. An in¬ 
struction begins with an instruction operation 
mnemonic. In some cases (such as IDL, RET, LDX, 
etc.) this mnemonic is all that needs to be specified. 
In most cases, however, the operation mnemonic 
must be followed by an operand. The form of the 
operand (i.e., the additional information which the 
programmer needs to supply to fully define the in¬ 
struction) depends on the type of instruction. The 
four operand forms follow. 

Register operands: Many instructions (e.g., INC, 
LDA, etc.) include a hex digit identifying one of the 
scratchpad registers. The operand field in such a 
statement may include either a single hex digit, or a 
symbol. For the last case, CRA uses the least 
significant hex digit of the symbol’s value in the 
symbol table as the register identifying field. 

Examples: 

DEC 9 

LDARF 

PLOSAVE 

(“SAVE=#0F” could have previously defined 
SAVE.) 

I/O device operands: The instructions OUT and 
INP require a device-identifying field. The operand 
in such a statement may be a single digit in the range 
1 to 7, or a symbol. Again, for the latter case, a 
symbol table lookup occurs, using the least significant 
hex digit of the symbol’s value (checking also that it is 
within the appropriate range). 

Examples: 

OUT 4 

INP READER 
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Branch addresses: Every branch instruction 
requires an operand specifying the branch address. If 
the mnemonic is a short branch, a one-byte operand is 
generated. A two-byte operand is generated if the 
mnemonic is a long branch. Whenever CRA sees a 
brancli operation mnemonic, it expects to next find an 
operand in llie fonn of an expression. The acceptable 
forms for expressions have already been defined. In 
case of a short branch, CRA evaluates the expression 
by getting a two-byte address, checks that this ad¬ 
dress is within the current 256-byte page by 
, examining the upper byte, and uses the lower byte as 
the .second byte in the instruction. For a long branch, 
the upper byte represents the page number, and the 
^ lower byte is the address within that page. 

Examples: 

If A(LABEL) is ^6789 

BZ LABEL 

generates #3289 

and LBZ LABEL 

generates #C26789 - 

Immediate operands: Several instructions include a 
second byte as an immediate argument. The operand 
field in such a statement may be any one-byte con¬ 
stant (i.e., an absolute or explicit constant or an 
address constant) or a symbol. For the latter case, 
CRA uses the least significant byte of tlie .symbol’s 
assigned value. 

Examples: 

XRIXTF’ 

ADI INCREM 

LDI A.0(*) 

Note: When an immediate argument Is specified, it is 
the programmer’s responsibility to make sure that it is 
a one-byte constant. If it is longer, CRA will not 
generate an error message, but will merely insert the 
entire constant into the output stream, possibly 
causing an error during program execution. 

Data Lists 

The typical program normally includes memory 
areas which contain data values. Statements which 
define initial data values are also code-producing 
statements (although the code generated is normally 
not executable |. The data list is a special statement 
provided for these purposes. It begins with either a 


comma or the special mnemonic “DC” (which stands 
for Define Constant ) and is followed by a sequence 
of one or more constants separated by commas. Each 
constant^ may be an absolute, explicit constant 
(hexadecimal, binary, decimal, or text) or an address 
constant or a symbol. For the last case, to be con¬ 
sistent with the treatment of symbols as immediate 
data, CRA substitutes the lower byte of the symbol’s 
assigned value. Thus, a constant in a data list is 
similar to an immediate operand, but now a length 
greater than one byte is entirely justifiable. 

Examples: 

DCX‘ABCD’,355 

,MBCDEF,T‘TEXT’ ,B‘011’ 

(Note: Any statement may be directly followed by a 
data list without the intervening semicolon. For 
example LDA 9,#3001.) 

CRA Directives 

The EQUATE DIRECTIVE (of the form 
SYMBOL=EXPRESSION) has already been 
discussed. Three other directive statements are also 
recognized by CRA: 

ORG Statement: This statement is written “ORG” 
followed by an expression. CRA executes this 
directive by setting the location counter equal to the 
value of the expression. 

Example: ORG *+20 ..Reserve 20 jq bytes of space 

PAGE ^statement: The PAGE directive, simply 
written PAGE , increases the value of the location 
counter to that of the beginning of the next 256-byte 
page; i.e., the upper byte of the location counter is 
incremented and the lower byte is set equal to zero. 

END ^statement: The END directive, written 
^ND , informs CRA to terminate the assembly. It 
should appear only once, as the last statement in the 
source program. The END directive is normally 
followed by a DC3 character. The DC3 is produced 
by the EDITOR to signify an end of file. 

1 hus, in addition to recognizing all the instruction 
operation mnemonics listed in Appendk G, CRA also 
recognizes the special mnemonics “DC”, “ORG” 
“PAGE”, and “END”. 

Additional Notes 

1) As noted earlier, a space is not permitted 
within a syntactic entity (symbol, mnemonic, con¬ 
stant, etc.). A space is not permitted between a 
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symbol being defined and the following colon or 
equals sign. Note, however, that a space within a text 
constant is permitted. It is translated into its ASCII 
equivalent code. There is a case where a space is 
required as a punctuation character. In order to 
distinguish an operation mnemonic (including ORG) 
from its following operand (if present), CRA expects 
to find at least one space. 

2) An apostrophe may be included within a text 
constant by preceding it with a “dummy 
apostrophe”. Thus, the string IT’s is written as a text 
constant as 

TIT’S’ 

3) Special control characters (non-printing 
characters, such as carriage return, line feed, etc.) 
should not be placed within the quotes of a text 
constant. Rather, they should be defined by splitting 
the text constant into two successive text constants, 
with the intervening control character represented 
with a hex constant (using its ASCII code). For 
example: 

,TLINEr,y^0D0A,TLINE2’ 

4) Several COSMAC instructions execute by 
automatically advancing the pointer to an operand 
byte after processing it. If the pointer to the operand 
byte is the same as the current program counter (for 
example, if X=P or if N=P), then the operand byte 
may be considered an immediate operand (provided 
an auto-increment occurs). A statement for such an 
instruction (under the conditions specified) is most 
conveniently followed by a comma followed by the 
one-byte immediate constant. This sequence is 
permissible because any statement may be im¬ 
mediately followed by a data list - omitting the in¬ 
tervening semicolon. 

For example, assuming P=0, the sequence SEX 
0; OUT 5 ,X‘52’ outputs the immediate hex constant, 
^52, to output port and continues. 

5) In general, any symbol may be referenced 
before it is defined in a program (termed a “forward 
reference”). Only one restriction exists: A symbol on 
the right-hand side of an EQUATE statement (i.e., in 
the expression) must have been previously defined. 

6) CRA uses the location counter value before a 
statement is processed as the value for any oc¬ 
curring within the statement. Thus, for example, for 
BR *+3, the value used for the * is the location 
where the branch byte (hex 30) will be placed, not one 
byte past that. Thus, BNl * will cause a program 
loop until flag I goes true. 


Code Examples and Review 

Fig. 24 is a hypothetical program designed not to 
do anything meaningful, but rather to present 
examples of various acceptable CRA statements. It 
contains a listing of the program and the 
corresponding output code generated. Fig, 25 con¬ 
tains the symbol table for the program. Both were 
generated by a typical CRA assembly run. 

In Fig 24, the left-hand column gives the location 
counter value before the line was processed. The next 
column give the output hex code generated at that 
location by the line. (Terminating semicolons in this 
column should be ignored. They are present to format 
the output file properly for subsequent loading of the 
object program. See later operating instructions.) The 
next column gives a source program line number for 
reference purposes, and Jinally the source code is 
reproduced. The rimning comments in the source 
program refer to the statement examples where they 
appear. 

By reading the source program in detail (paying 
special attention to the running comments), one can 
quickly review much of what has been said con¬ 
cerning COSMAC Level I Assembly Language. 
Output code values may be verified by referring to 
Appendices E and F. In particular the reader should 
verify the values assigned to the symbols in Fig. 25. 

Error Messages 

Whenever CRA detects a violation of its syntax 
rules, it generates an error message. There are, 
however, some possible program errors which will not 
be detected by CRA because they do not result in 
syntax rule violations. For example, R3=8; INC R3. 
R3 is now a symbol, the value of which is 8, so 
register 8 gets incremented. 

When there is a syntactical error, CRA indicates it 
first, by printing the line in violation using its 
standard listing format (location counter, output 
code, line sequence number, source line); second, by 
inserting a “?” at the detection point in the source 
line; and third, by printing an error code on the next 
line. If the error is detected at the end of the line, the 
“?” may be omitted. In most cases, by looking up the 
error code meaning in the listing which follows and by 
noting the position of the inserted “?”, the user can 
easily determine the nature of the error. 

It should be emphasized, however, that it is 
possible that an error at one point in a source line may 
be interpreted by CRA as an error at a different 
point. For example, in T’TEXT...COMMENT, a 
single quote is missing after TEXT. It will not be 
detected until the end of the line. (In fact, if the 
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LOCATION 

COUNTER 

0000 
0000 
0000 
0000 
0000 
0000 
0000 
0603 
0003 
bo03 
0003 
0004 
0005 
0007 
0009 
000 E 
0013 
0016 
0017 
0018 
0019 
001A 
001A 
001C 
001 E 
001 E 
0020 
0022 
0032 
0100 
0102 
0104 
0104 
0105 
0105 
0106 
0108 
010A 
OlOD 
010F 
0110 
0111 
0000 


OUTPUT 

CODE 


LINE 

NUMBER 

0001 

0002 

0003 

0004 

0005 


SOURCE LINES 

. THIS PROGRAM IS NOT DESIGNED TO DO 
ANYTHING MEANINGFUL. RATHER, IT IS 
DESIGNED TO ACT AS A REVIEW AND 
SUMMARY OF THE COSMAC LEVEL 1 



0006 

. . A LINE MAY CONSIST ONLY OF A COMMENT 

0078F0; 

0007 

IDL;SAV;LDX 

. . MULTIPLE STATEMENTS ON LINE 


0008 

CRLF = #0D0A 

. . SYMBOL DEFINED VIA EQUATE 


0009 

TALLY = 9 

. . SAME, USING DECIMAL CONSTANT 

' 

0010 

PTR = TALLY + 1 

. . EXPRESSION CONTAINS SYMBOL 

29; 

or\ 

0011 

LOOP: DEC TALLY 

. . SYMBOL DEFINED VIA LABEL 

89; 

0012 

GLO TALLY 

. . TALLY IDENTIFIES A REGISTER 

3A03; 

0013 

BNZ LOOP 

. . EXPR CONTAINS SYMBOL ONLY 

3016; 

0014 

BR SAMI 

. . A FORWARD REFERENCE 

ABCD400100; 

0015 

,X'ABCD',64,D'256' 

. . SOME CONSTANTS 

0354455854; 

0016 

DC B'Oir,T'TEXT' 

. . MORE CONSTANTS 

001 20A; 

0017 

,A(* - 1),A.0<CRLF) 

. SOME ADDRESS CONSTANTS 

1 A; 

0018 

SAMI: INCA 

. REG NAMED WITH HEX DIGIT 

2B; 

0019 

DEC RB 

. REG NAMED WITH "R" FORM 

67; 

0020 

OUT? 

. EXPLICIT DEVICE NUMBER 

6F; 

0021 

INP READER 

. DEVICE IDENTIFIER IS SYMBOL 

; 

0022 

READER=7 

. ANOTHER FORWARD REFERENCE 

F841 ; 

0023 

LDI T'A' 

. 1-BYTE IMMEDIATE CONSTANT 

FC05; 

0024 

ADI NUMBER 

. SYMBOLIC IMMEDIATE CONSTANT 


0025 

NUMBER = X'05' 

. EVEN NUMBER OF HEX DIGITS 

3600; 

0026 

B3 LOOP-#03 . 

. BR ADDRESS IS EXPRESSION 

3C22; 

0027 

BN1 * + 2 

EXPR REFERS TO LOC COUNTER 


0028 

ORG *+#10 

. ADVANCE LOC CTR 16 BYTES 


0029 

PAGE 

. ADV LOC CTR TO NEXT PAGE 

6710; 

0030 

OUT 7,16 

. IF X = P, #10 IS DATA OUT 

4205; 

0031 

LDA 2, NUMBER . 

. IF P = 2, SAME AS LDI #05 


0032 F = 2 

12; 0033 INCF 

; 0034 LABEL: ORG 

78; 0035 RET: SAV; 

7078; 0036 RET; SAV; 

F801; 0037 LDI A.1 (LABEL) 

F80105; 0038 LDI A(LABEL) 

F805; 0039 LDI LABEL 

1A; 0040 INCCRLF 

OA; 0041 ,CRLF 

; 0042 END 


BAD PRACTICE TO REDEFINE A HEX CHAR SINCE 
THIS WILL INCREMENT R2, NOT RF. 

. . AN EASILY-MOVEABLE LABEL 
. . ''RET'^ IS A LABEL HERE 
- . '^RET" IS AN INSTRUCTION 
. . A PROPER 1-BYTE IMMEDIATE 
. . ERROR. NO DIAGNOSTIC GIVEN 
. . LOWER BYTE USED ONLY 
. . LOWEST HEX DIGIT USED ONLY 
. . LOWEST BYTE USED ONLY 
. . REQUIRED LAST STATEMENT 


Fig. 24 - CRA fisting of sample program. 


Hex 

Value 

Symbol 

ODOA 

CRLF 

0009 

TALLY 

OOOA 

PTR 

0003 

LOOP 

0016 

SAMI 

0007 

READER 

0005 

NUMBER 

0002 

F 

0105 

LABEL 

0105 

RET 

0000 



Fig. 25 - Symbol table for sample program of Fig. 24. 
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comment happens to end in a single quote, the error 
will go undetected.) Further, and more important, it 
is possible for the error code to indicate one type of 
error when another actually occurred. For example, 
the statement SAM INC 3 is missing a colon after the 
label SAM. The primary meaning of the error code 
which will return in this case is: “unrecognized 
mnemotiic”. This response is understandable because 
if CRA does not detect a colon or an equals sign, it 
asstinies that the statement does not begin with a 
symbol. If therefore expects a mnemonic or a comma 
and does not find either. 

An error on one line may cause several lines to be 
agged. This response typically occurs when a line 
containing a label is flagged because of a missing 
colon and all subsequent references to that label are 
also noted as “undefined.’’ 


Whenever an error exists, the output code is 
questionable. However, as best it can, CRA in¬ 
crements its location counter past this code and 
continues to process the source program, possibly 
detecting further errors which it flags similarly. 
Detection of an error does not stop assembly of a 
program. CRA continues in its attempt to find all 
syntax errors. 

The possible error codes and their meanings are 
given in Table VII, and a summary of error messages 
is given in Table VIII. If in the process of generating 
a listing CRA creates a line that exceeds the standard 
length (typically 78 characters), the line is broken by 
a (CR) (LF) sequence. The rest of the line is con¬ 
tinued on the next line but is preceded by a con¬ 
tinuation mark - a period. 


TABLE VII - CRA ERROR CODES AND THEIR MEANINGS 
Error 

Code Meaning 

01 UNRECOGNIZED MNEMONIC OR MISSING COMMA 

The body of a statement (other than EQUATE) must begin with either 
a valid operation mnemonic or DC, ORG, PAGE, END, or a comma. 

02 PREVIOUSLY DEFINED SYMBOL 

An attempt has been made to define a symbol which already has an 
entry (and a value) into the symbol table. 

04 INVALID CHARACTER WITHIN BINARY CONSTANT 

CRA is in the process of evaluating a binary constant and has found a 
character other than 0/1 or the trailing single quote (which may be missing). 
05 BINARY CONSTANT TOO LONG 

The limit is eight bits. 

06 EXPECTED HEX OR DECIMAL CONSTANT HERE 

CRA is in the process of evaluating an expression or a constant and 
expects to see a hex or decimal constant at this point and does not 
find one. (Note: Under certain conditions, this diagnostic may 
occur as the result of an undefined symbol.) 

07 UNDEFINED SYMBOL 

CRA encounters a symbol reference and wants to use its value, but 
does not find it listed in the symbol table. 

08 EXPECTED EXPRESSION HERE 

CRA determined that an expression was to follow next and did not 
find leading characters which were proper. 

09 INVALID CHARACTER WITHIN HEX CONSTANT 

CRA is in the process of evaluating a hex constant and has found an 
invalid character. (This error code may be caused by an uneven number 
of hex digits.) 

10 MISSING TRAILING QUOTE IN TEXT CONSTANT 

Note that the error marker "?" will not appear because this error is 
always detected at the end of a line. 

11 PERIOD ERROR 

Either illegal use of a single period or a missing period beginning 
a comment. 

12 LEADING CHARACTER ERROR 

At the beginning of a statement, a leading alphabetic or comma was not 
found. 


(Cont'd) 
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TABLE VII - Cont'd 

14 BRANCH OUT OF PAGE 

A branch address was evaluated and the upper byte did not agree with 
that of the location counter (see Note 1). 

15 INVALID REGISTER NUMBER 

The LDN RO is an iilegai operation. It would otherwise assembie into 
a hex 00 operation code, the code for an idle instruction. 

16 DEVICE NUMBER OUT OF RANGE 

In an OUT or INP instruction, the expiicit or symbolic device number 
had a vaiue greater than 7. 

OVFL SYMBOL TABLE SPACE EXHAUSTED 

The amount of RAM aiiocated to the symboi tabie has been used up. 

The user must remove labeis by, for exampie, using *'s more often or 
branching reiative to existing labels. The program can also be broken 
up into parts, or more RAM can be added to the CDS. (Note: This 
error condition haits CR A. A restart of the assembler is required, i.e., $U). 


Notes 

(1) Whiie CRA makes every effort to increment the location counter properly 
when it processes statements which contain errors, it is, of course, possible 
for the location counter to have a value at any given point which is different 
from that which it wouid have for an error-free program. As a result, it is 
conceivable that the BRANCH OUT OF PAGE error diagnostic either wiii 
occur erroneously or will not be generated when it should be. 

(2) The semicolon separating multiple statements in a line is used mainly 
as a checking device. When CRA has processed an error-free statement 
and is reinitiaiized to iook at the next one, the intervening semicoion 
is merely ignored. Thus, it is not reaily mandatory that the semicoion 
be used between two statements on a iine, if the first is "known" not 
to contain errors. Clearly, however, it is a necessary practice not only 
for readability, but also for verification purposes. 


TABLE VIII - SUMMARY OF CRA ERROR MESSAGES 
Error 

Code Meaning 

01 UNRECOGNIZED MNEMONIC OR MISSING COMMA 
02 PREVIOUSLY DEFINED SYMBOL 

04 INVALID CHARACTER WITHIN BINARY CONSTANT 
05 Bl NARY CONSTANT TOO LONG 

06 EXPECTED HEX OR DECIMAL CONSTANT HERE 
07 UNDEFINED SYMBOL 

08 EXPECTED EXPRESSION HERE 

09 INVALID CHARACTER WITHIN HEX CONSTANT 

10 MISSING TRAILING QUOTE IN TEXT CONSTANT 

11 PERIOD ERROR 

12 LEADING CHARACTER ERROR 

14 BRANCH OUT OF PAGE 

15 INVALID REGISTER NUMBER 

16 DEVICE NUMBER OUT OF RANGE 
OVFL SYMBOL TABLE SPACE EXHAUSTED 
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CRA Operating Instructions 

Summary of CRA Operating Steps 

Before a summary of the detailed operating steps 
for CRA is given, it should be pointed out that the 
source file which CRA processes may be derived in 
any one of several ways. First, it may be written on 
magnetic or paper tape from the keyboard by 


operating the terminal in the LOCAL mode. Second, 
it may already exist (saved) in a remote system; e.g., a 
time-sharing system. In this case it can be 
automatically written on a local tape through a 
communications link, for example. Third, and 
preferably, it may be generated by use of the 
COSMAC Resident Editor program, which will be 
discussed next. In any event, it is assumed that such a 
source tape exists as a prerequisite to the operating 
steps listed in Table IX. 


TABLE IX - SUMMARY OF CRA OPERATING STEPS 

1. Load CRA into RAM using the following steps. 

a. For Tl terminal in LINE mode: 

Press RESET, then RUNU, then CR to initialize UT20. 

Mount CRA program cassette. 

Rewind cassette. 

Press LOAD/FF to advance to the first file. 

Press CONT/START to start reading file. 

b. For Teletype terminal in LINE mode: 

Press RESET, then RUNU, then CR to initialize UT20. 

Mount paper tape in reader. 

Place READER CONTROL switch (previously installed) in MANUAL position. 

Press START on the tape reader. 

After completion, set READER CONTROL switch back to REMOTE (program 
control) position. 

CRA is now loaded into memory. 

2. Mount input source. If paper tape, turn reader on. READER CONTROL switch 
should be in REMOTE position. 

3. Mount output object tape. If paper tape, do not turn punch ON yet. 

4. Type $U(CR) to transfer control to CRA. 

5. CRA begins by typing ?, asking user to identify type terminal in use. In response, 
type P for "punch" if a Teletype terminal, or any other character if Tl terminal. 

6. After CRA prompt message (? F, H, L, U =), type F. CRA will then execute its 
first pass, generating a symbol table and possibly some error diagnostics. If Tl 
terminal is used, source tape will be automatically rewound after completion. 

If Teletype terminal is used, source tape must be repositioned. After completion, 
CRA will repeat prompt message. 

7. Type L. Listing will ensue. If Tl terminal is used, an object tape will be written 
automatically. 

8. Insert this step only to effect Teletype terminal third pass. This pass will punch 
the object code paper tape. First, turn the paper punch ON. Then reposition the 
source tape and respond to new CRA prompt message by typing H. 

9. After CRA has completed the assembly, and if the object tape is to be run, 
the user must initialize the object tape for reading. (For the Tl terminal, 
the object tape is already rewound and the user need only change the 
controls on the terminal so that the just-RECORDED cassette now becomes 
the PLAYBACK cassette.) Respond to the new CRA prompt by typing U 
followed by a CR. UT20 will assume control and deliver the ^ prompt. By 
following the steps given in 1 (a) or 1 (b), the object tape can be loaded into 
memory. Control is transferred by the appropriate $U(CR) command. 
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RAM Considerations 

The CRA program occupies approximately 2.5 
kilobytes of memory. It is supplied on UT20- 
compatible paper tape for TTY use and on cassette 
for use with the TI terminal, 

CRA requires an additional work space of at least 1 
kilobyte of RAM for I/O buffers and, particularly, 
for the symbol table which it constructs and 
references. Most of the available RAM work space is 
used for the symbol table. Each entry has a variable 
length and contains the symbol (one byte per 
' character), a special delimiter control byte, and a 
-two-byte value. Because a symbol is 1 to 6 bytea in 
length, each symbol entry is 4 to 9 bytes in length. 
CRA makes use of additional RAM apace, if it has 
been provided, by starting at location 8000, 
decrementing down, and testing for RAM by suc¬ 
cessive write/read operations. It stops when the first 
RAM byte is found and assumes that RAM exists 
from there down to location 0000. Therefore, any 
added RAM must be contiguous to the original 4 
kilobytes supplied. 

In 1 kilobyte of work space, .there is room for 
approximately 80 symbol table entries depending, of 
course, on the average symbol length. The required 
work space is not a function of the number of 
statements in the source program being assembled. 
Rather, it is a function of the number of symbols 
defined within it. 

CRA is a two-pass assembler. That is, normally it 
reads the complete source file twice to complete an 
assembly. During the first pass, the symbol table is 
constructed in RAM and printed on the terminal. 
Syntactic errors are flagged. On the second pass, 
object code ia generated using the symbol table values 
just derived and an assembly listing is printed. 
Addition program errors may be flagged on the 
second pass. For example, the UNDEFINED 
SYMBOL error normally occius here. 

Output Options 

When the TI terminal is used, the output or 
object tape is generated automatically during the 
^cond pass. This terminal includes means by which 
information printed on the printer may be different 
from that which is written on the output tape cassette. 
In this case, after the second pass, while the printed 
listing contains all the information discussed earlier 
(i.e., output code values and associated addresses, 
and .sequence numbers and associated source lines), 
the output tape contains only output code and address 
information in a format compatible for subsequent 
jp^iding via UT20. The output tape file begins with a 
‘MM” message, followed by a sequence of lines which 


have the UT20 semicolon loading format (where each 
line begins with an address followed by a sequence of 

hex digits to be loaded there, terminating with a 
semicolon). 

If the I/O terminal is a teletypewriter, on the other 
hand, then when the paper tape punch is activated, 
information punched on the tape is the same as that 
printed on the printer. Thus, if the punch were turned 
on at the beginning of a second pass, the entire listing 
would be written on the output paper tape. The 
resulting tape could be used for subsequent loading if 
desired because UT20 ignores any information on an 
input ! M line after the semicolon has occurred. 
However, this procedure has several disadvantages. 
The output tape is much longer than it has to be, with 
most of the information on it extraneous. As a result, 
the time to read it (during subsequent loading), 
particularly at 10 characters per second, is normally 
prohibitive. To handle this problem when a Teletype 
terminal is used, CRA includes the ability to make 
two kinds of “second passes” one of which omits the 
printing of the source program lines and their 
associated sequence numbers. Thus the normal 
procedure to generate a paper tape object file is to 
make a third pass (of the type just described) over the 
source file to generate an output tape which contains 
the same information as would be written on a 
magnetic tape cassette during the second pass. 

Thus, several paper-tape, second-pass options exist 
for the user. First, the normal second pass (generating 
a listing) may be elected (option L) with the punch 
off, waiting for the third pass to generate the output 
tape (option H). Second, particularly for short 
programs, the punch may be activated for this listing 
pass - in which case the output tape will be longer 
than necessary, but a third pass will not be required. 
Third, particularly if an adequate listing already 
exists as the result of a previous run, the user may 
elect the object-code-only option (H) on the second 
pass, with the punch turned ON. 

Prompt Messages 

CRA begins any pass with a prompt message 
which appears as 

?F,H,L,U= 

asking the user to type one of the letters shown to 
define what CRA will do next. It Is assumed that all 
I/O media involved - input and output magnetic or 
paper tapes - are properly mounted. Typing F selects 
the first pass (symbol table construction). Typing L 
selects the Listing pass (the normal second pass). 
Typing H selects the Hex-only listing pass (the 
normal third pass when paper tape is used). Typing U 
causes CRA to return control to UT20 (presumably 
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after the completion of an assembly, in order to load and prints an prompt as usual. The user may 
the program just assembled). IJT20 receives control then re"initialize the object tape for loading and 

running. 

Informal Introduction to the 
COSMAC Resident Editor 


After the user has written his COSMAC assembly 
language program and wants to assemble and run it, 
>he immediately faces the problem of converting the 
hand-written source file into a machine-readable 
form. This conversion involves a keyboard-to-tape 
operation in which lines on the coding sheet are 
transcribed to become lines on a source tape. 
Although an “off-line” process can be executed, in 
which the I/O terminal is operated in the LOCAL 
mode, it is much more likely that the COSMAC 
Resident Editor will be used at this point to create the 
source tape. The reason is that use of the Editor 
provides assurance that the created files are in proper 
format for later reading by the Assembler and for 
later modification, if necessary, by the Editor. Details 
on formats are given in the description of the Editor 
which follows in the next section of this Manual, 

Once a source file has been created and a first 
Assembly run made, it is very likely that error 
diagnostics will be returned by CRA asking for 
corrections to the source file to conform to CRA’s 
rules. Typically, the changes required at this point 
are “trivial” but necessary. For example, spaces may 
have to be removed in one or more expressions. The 
same symbol may have been erroneously used for two 
purposes. An operation mnemonic may have been 
misspelled or a punctuation character such as a 
comma, colon, or single quote omitted. The number 
of possible trivial errors is clearly large. 

To correct the errors and to alter the source file to 
conform the program to the CRA rules, the Editor is 
used. Typically, modifications at this point merely 
involve insertion and deletion of single characters or 
replacement of a small string of characters by a 
substitute string. The erroneous source file is used as 
an input to the Editor and the user generates a 
corrected soiuce file as an output. The new file is then 
re-assembled. At this point other trivial errors may 
appear which were not apparent to CRA on the first 
run. For example, an erroneous instruction operand 
may not have been flagged on the first assembly 
because its associated statement label or operation 
mnemonic may have also been in error. Thus, a new 
Edit-Reassemble pass may be necessary. Finally, a 
program is developed to which CRA does not object. 
At this point, a first run can take place. 


The probability of a logical error in the program 
depends on its length and the previous experience of 
the programmer. Assuming one or more logical errors 
are found (via some “debugging” procedure), the 
source file must again be modified. Often such 
modifications are no longer trivial. For example, it 
may be necessary to find all instructions which 
branch to a given location and precede some of them 
with one or more instructions currently not in the 
program. Often, it may be necessary to delete some 
code or insert some code or move some code to a 
different point in the program. Several duplicated sets 
of in-line instructions may have to be removed and 
replaced with calls to one common subroutine which 
is to be added. The user may decide to “clean up” the 
program logically, in any one of several ways, or to 
improve its “readability” by modifying its comments 
or statement formats (by inserting TAB s or 
space’s, for example). 

Such modifications to the source file also involve 
use of the Editor. After they are completed, a 
reassembly may again turn up new errors of the 
“trivial” variety. And so on. Thus the generation of a 
bug-free program typically involves the chart shown 
in Fig. 26. It is thus quite likely that the amount of 
time spent “conversing” with the Editor will be much 
larger than that spent with the Assembler. 

CREATE SOURCE FILE 
USING EDITOR 

I \ i i I 

FIX "trivial" errors (RE) ASSEMBLE FIX LOGICAL ERRORS 
USING EDITOR ANY ERROR DIAGNOSTICS? USING EDITOR 



1 

RUN 

ANY BUGS? 

NO -YES 

l 

PROGRAM WORKS 


92CS-28I9B 


Fig. 26 — Flow chart for "bug-free" program. 
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A source program may be viewed as a long 
sequence of characters. When the COSMAC 
Resident Editor reads the source file, it places this 
character sequence in memory, with the code in each 
memory byte representing one source program 
character. The user is then free to type commands to 
the Editor to manipulate the memory representation 
of the program. For example, the user may identify a 
specific location and specify a character sequence to 
be inserted there. He may also identify certain 
characters to be deleted or altered. He may ask the 
'Editor to search for the occurrence of specific 


character sequences, after which further memory 
modifications (corrections) may be made. (Details of 
available commands are given later). 

After he is satisfied that the new memory 
representation of the file contains all the desired 
changes (frequently the user begins an editing session 
with a hand-written list of the changes to be made), 
he asks the Editor to write (create) a new file con¬ 
taining the new version of the program. This new file 
is then used as the input file for a reassembly. 


COSMAC Resident Editor 


The COSMAC Resident Editor (CRE) is a 
program which facilitates creation and modification 
of local COSMAC file. These files are stored on paper 
tape or on magnetic tape in cassettes. Typically, they 
are COSMAC source programs. However, they may 
also be any other kind of conventional document. 
CRE runs directly on the COSMAC Development 
System itself in a stand-alone m.anner. No external 
computational facilities are required. 

CRE Operating 
Considerations 

Memory Space Requirements 

The CRE program occupies approximately 2.5 
kilobytes of memory space. Like CRA, it is supplied 
on paper tape and in a cassette for loading into the 
RAM of the COSMAC Development System. All the 
information previously given regarding loading and 
transferring control to CRA applies equally to CRE. 
See Table IX Summary of CRA Operating Steps in 
CRA Operating Instructions. 

CRE requires about 100 bytes of the RAM work 
space for its own internal purposes. The remainder of 
the available RAM space is used as an editing area 
called a buffer. Virtually all CRE operations involve 
the buffer. CRE is designed to take advantage of all 
of the available RAM space for its buffer area. 
Approximately 1400 bytes are available for this 
purpose in the 4 kilobytes of RAM supplied with the 
Development System. If more RAM is present in the 
system, CRE will automatically add it to its buffer 
area. It tests for additional RAM the same way CRA 
does. 


Input and Output Files 

Normally, a user creates a file using CRE by filling 
the buffer from the I/O terminal keyboard and then 
causing CRE to write this information onto an output 
tape (which will contain the created file). 

An existing (input) file may be modified (edited) by 
reading portions of it into the buffer, then using CRE 
commands to alter the contents of the buffer, and 
finally writing the results onto the output file. 
Typically, the output file is a new version of the input 
file. After an editing session, the new version is 
retained and the old version is discarded (although it 
may be temporarily saved for future reference or 
backup). 

Thus CRE has means to read an input file into the 
buffer, means to examine and modify the contents of 
the buffer in many ways, and means to write the 
buffer contents onto an output file. Alternatively, 
when an input file does not exist, the user creates an 
output file by loading the buffer from the keyboard. 

Record Formats 

In order to understand the various commands 
which CRE is designed to execute, it is fundamentally 
important that the user understand how information 
is normally recorded on the I/O media (tapes) and in 
the buffer. 

A file is a sequence of records or lines. Each line 
consists of a sequence of characters. The length of a 
line is restricted to 78 or fewer characters of data. 
Thus, a line in a file is normally printable as a line on 
the I/O terminal printer. Each character is 
represented by an 8-bit code or byte, either on the 
tape or in memory. Typically, every character in a 
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line is a printable character (including space or 
blank). Every non-printing character code represents 
a control character. A control code may be generated 
on the keyboard either by hitting an appropriately 
marked key (e.g., RETURN, ESC, etc.) or by 
depression of the CTRL button while hitting another 
key. The printer reacts to the receipt of a control 
character in one of several possible ways. Some 
control characters (such as carriage return, line feed, 
bell, etc.) cause the printer to execute a specific 
control function. Other control codes either are 
ignored by the printer or may cause the equivalent of 
a space on the printed line. 

A line in a file may contain control characters 
(with certain restrictions to be discussed later). If it 
does, it is quite possible that its printed record will not 
completely reflect the true contents of the line. CRE 
treats most control characters which it encounters 
within a line in the same manner as it treats printing 
characters. However, certain control characters have 
special meaning to CRE. 

The proper format for tape files is shown in Fig. 27. 
Each line is terminated with a CARRIAGE 
RETURN (CR), LINE FEED (LF) pair, followed 


by a field of six nulls. The NULL character (hex code 
00) is ignored by the system. A set of nulls appears 
after each CR, LF, pair merely to provide a sufficient 
time delay for the printer carriage to settle to the new 
line when the tape contents are being printed. Note 
that the last line on the tape should be followed by a 
“dummy” line containing only the single data 
character DC. DCS is a special control character 
(generated on the keyboard by hitting CTRL and S). 
It acts as an END OF FILE indicator. Note also that 
if the file is stored on paper tape, it is normally 
preceded by a leader of nulls and followed by a trailer 
of nulls. The null leader permits arbitrary initial 
positioning of the tape in the reader. 

Tape records read by CRE are deposited into the 
buffer as they appear on the tape, but with all LF s 
and NULL’s ignored. (Incidentally, the DEL or 
RUBOUT character, hex code 7F, is also ignored on 
tape input) While CRE operates on the data in its 
buffer, it specifically uses the CR character as an 
indicator of the end of a line. (Recall that a line has a 
variable length.) A new line is assumed to start with 
the next character in the buffer. The buffer format is 
shown in Fig. 28. 
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Fig. 27 — Tape fUe format. 
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Fig. 28 — Memory buffer format. 
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When CRE is depositing keyboard data into its 
buffer, the ASCII code equivalent of each struck key 
(any printing character, and almost any control 
character - with exceptions as noted below) goes into 
memory and is also “echoed” back to the printer. 
However, CRE specifically ignores the LF key. 
Further, when the RETURN key is hit, the CR 
character goes into memory and a CR,LF pair of 
characters is echoed back to the printer to start a new 
line. Thus, the user terminates a line of keyboard 
input with a single carriage RETURN. Normally, 
then, the LF character should not appear at any point 
in the buffer. 

Whenever CRE transmits a CR character to the 
terminal, it automatically appends to it the LF, six 
NULL field to maintain the tape format just 
discussed. 

It is conceivable that due to a user error, one or 
more lines on the input file or in the buffer may ex¬ 
ceed the 78 data character length restriction. For 
example, the input tape may have been erroneously 
prepared off line with the terminal operated in the 
LOCAL mode. Alternatively, data alterations in the 
buffer may have resulted in deleted CR’s. (Note that 
each CR deleted in the buffer causes the con¬ 
catenation of its adjacent lines.) CRE has the 
following provisions for handling lines which exceed 
the length restriction; 

(1) Whenever CRE is outputting a line to the printer 
as the result of a user TYPE command, if the line 
exceeds 78 characters, a “LINE TOO LONG” 
message will also be printed. 

(2) IF CRE encounters too long a line while writing 
from the buffer to the output tape, the line will be 
broken up, using as many 78-data-character records 
as are necessary - each terminated by an appended 
CR, LF, 6-NULL field. 

(3) A line which is too long on the input file is 
truncated to 78 characters, with a CR appended, in 
the buffer. 

Buffer Pointer 

The total RAM space available for the buffer is 
generally partially filled. When CRE is first 
initialized, the buffer is empty. When data is added to 
the buffer (from the keyboard or from the input tape) 
the buffer expands. When data is deleted, the buffer 
contracts. CRE continually keeps track of the present 
extent of the buffer within the work space. 

CRE maintains a virtual pointer which iden¬ 


tifies some point between two characters in the 
buffer. This pointer has the same fimction as what is 
commonly called a “cursor”. Most CRE operations 
are executed relative to this pointer. Further, several 
CRE operations exist specifically to alter the location 
of the pointer. It is essential,, therefore, that the user 
be aware at all times of the current location of the 
pointer. Because the pointer is not visible, it is the 
user’s responsiblity to keep track of where the pointer 
is. Often, its location is verified by asking CRE to 
type information in the buffer at the current pointer 
position. Alternatively, the user may first initialize 
the pointer to a known reference point (e.g,, the 
beginning or end of a line, or the beginning or end of 
the buffer) and then move it relative to this known 
origin. 

In illustrative examples, the location of the 
pointer is indicated with an arrow below and between 
the two buffer characters. For example, in 

ABCDE 

t 

the character before the pointer is B and that after the 
pointer is C. 

Unless otherwise noted, whenever text is deleted 
from the buffer, the character sequence to be deleted 
exists either immediately to the right or immediately 
to the left of the pointer. After the deletion, the buffer 
has contracted by the number of characters deleted. 
If the field deleted is to the right of the pointer, the 
character immediately to the left of the pointer 
remains the same. The character to the right of the 
pointer then becomes the character that was im¬ 
mediately to the right of the deleted field. A 
corresponding statement can be made for deletion to 
the left of the pointer. 

When text is inserted, the buffer expands. Unless 
otherwise noted, text is inserted between the two 
characters at the position of the pointer. After the 
insertion, the pointer is positioned immediately after 
the inserted text. Thus, the character to the right of 
the pointer remains the same. 

The execution of many CRE operations starts at 
the present pointer position and proceeds either 
towards the end or towards the beginning of the 
buffer. CRE insures that the pointer cannot be moved 
past the present limits of the buffer. If the pointer 
reaches the beginning or the end of the buffer, the 
operation stops - leaving the pointer at that point. For 
example, if the pointer is positioned n characters from 
the end of the buffer and the user asks to move the 
pointer m characters to the right, with m>n, then the 
operation will stop after the buffer pointer has been 
incremented by only n. 
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CRE Command Operation 

Command Strings 

When control is first transferred to CRE, a “?” 
prompt is given, asking the user to identify the kind of 
I/O terminal in use. In response, the user types either 
P (for “punch”) if a Teletype terminal is used, or any 
other character if a TI terminal is used. As will be 
explained further later, CRE must be aware of 
whether or not the output tape is to be punched 
because it has no direct means of turning the paper 
tape pimch on and off. It must rely on the user to 
manually turn the ptmch on and off at appropriate 
time. 

After the I/O terminal has been identified, CRE 
will print the initial message. 

COSMAC TEXT EDITOR VERSION XX 

and then follow this with its “ ^ ” user prompt 
character. If the I/O device is a Teletype terminal 
CRE will precede this prompt by punching a 
leader of 60 NULL’s on the output tape. (See later 
discussion on Punch Procedure.)' The -> prompt 
always indicates that CRE is ready to receive a new 
user command from the keyboard (having executed 
the previous one). 

After receiving the ^ , the user types a sequence of 
one or more commands which CRE will execute in 
order. Most commands may be optionally delimited 
(ended) by a special termination control character. 
Commands which include text arguments of variable 
length must include this character to define the end of 
a text field. A CRE command string is always ter¬ 
minated by the occurrence of two successive ESCape 
or ALT MODE characters or its equivalent (the 
control character whose ASCII code is a hex IB, if 
neither ESC or ALT MODE is labeled on the 
keyboard). 

The I/O terminals discussed here, operate in the 
full duplex mode, in which the data path from the 
keyboard to the CDS is distinct from that between the 
CDS and the printer. Normally, a program merely 
“echoes” back to the printer what it has just received 
from the keyboard. However, whenever CRE 
receives an ESC or ALT MODE character, it is 
echoed back to the printer followed by a $ - giving 
a visual indication of the ESC key depression. Thus, 
a typical command string normally appears on the 
printer as 

COMMANDl$COMMAND2$ .. . COMMANDn$$ 


where in most cases the separating ESC’s are optional 
but the final pair is mandatory. (If ESC is not hit, the 
$ will not appear, of course.) A command string 
must be terminated by two depressions of the 
E$C key. 


Command Formats 

The heart of the command is a single letter 
mnemonic (such as “T” for TYPE, “I” for INSERT, 
etc.). In many cases, this letter may be optionally 
preceded by a decimal number (later denoted by n) 
indicating the number of characters or lines involved. 
Further, in some cases this number may be preceded 
by a minus sign (-) indicating a direction (from the 
present pointer position) toward the beginning of the 
buffer rather than toward the end (as is normally 
assumed). If no number is present, CRE assumes the 
value 1. 

Given an arbitrary pointer location, the possible 
CRE interpretations for n are normally as follows: 


(1) Character Operations: Positive n identifies the 

n characters to the right of the pointer (in¬ 
cluding control characters). Negative n 

identifies the n characters to its left. Unless 
otherwise noted, n=0 results in no operation. 

(2) Line Operations: Positive n identifies all 

characters to the right of the pointer up to and 
including the nth CR encountered. If the 
pointer is in the middle of a line, the first line 
will constitute only the remainder of that line. 
Negative n identifies all characters to the left of 
the pointer up to but not including the -n+lst 
CR. If the pointer is in the middle of a line, the 
last line (in this set of lines) will consist of only 
those characters in the present line to the left of 
the pointer. Thus, n=0 specifically indicates 
the portion of the present line to the left of the 
pointer. 


In certain cases a command mnemonic letter is 
followed by one or two variable-length text 
arguments (whenever the user needs to specify some 
sequence of characters to insert or to search for). All 
such arguments must be terminated by the ESC 
character (echoed as $). In subsequent discussion, an 
arbitrary text argument will be denoted by a symbolic 
statement such as 
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Punch Procedure 

Assuming the output file is to be punched on 
paper tape (i.e., the terminal device is a Teletype 
unit), CRE needs a mechanism to activate and 
deactivate the tape punch to properly bracket the 
infomiation being output. Because CRE has no direct 
control of the punch, it must rely on the user. 
\^henever CRE wants to output to the punch, it types 
the message 

START PUNCH, TYPE DEL 

and then idles, awaiting the user’s hitting of the DEL 
^ or RUBOUT key (whose hex code is 7F). The user 
should first manually turn the punch ON and then 
strike DEL. CRE will proceed to punch data. On 
completion, it will again idle awaiting another DEL 
which will indicate that the punch has been deac¬ 
tivated. The user should first manually turn the 
punch OFF and then strike DEL. CRE will then 
continue. 

Note, in particular, that this process occurs at 
the initiation of an editing session when CRE 
automatically punches the initial 60-null leader on the 
output paper tape. 

Correcting Command 
Typing Errors 

A typing error in a command string may be 
corrected by use of the RUBOUT (DEL) character to 
“erase” previous characters already typed. Each time 
CRE receives a RUBOUT within a command string, 
it erases the last character from its stored version of 
the command string. Further, it echoes back to the 
terminal the character just erased. For example, 
suppose the user types the command string ABCSDE 
(each of the letters is a valid command mnemonic) 
followed by four rubouts. On the terminal, he would 
see 

ABC$DEED$C 



where the last four characters were those erased. The 
characters AB would then remain in CRE’s stored 
command string register. 

Clearly, any such erasures must occur before the 
double ESC character, which terminates the com¬ 
mand string, is struck. 


If CRE finds an invalid command while in 
execution of a command string (i.e., after the user has 
typed the double ESC), it returns to the user the error 
message 

BAD COMMAND? ?“xxxx..xx$” 

where xxx..xx reproduces that part of the command 
string which has not been executed. 

Interrupting CRE Execution 

The user may at any time stop CRE execution by 
depressing and holding the BREAK key on the 
keyboard. This key is used, for example, to stop a 
long typeout. On receipt of the BREAK, CRE stops 
execution at whatever point was reached and returns 
to the command input mode by issuing another 
prompt. To assure the clean entry of succeeding 
commands, the DEL key should be depressed to erase 
any erroneous noise characters that may have been 
entered as a result of the break. 

After a BREAK, the user should normally verify 
or reinitialize the buffer pointer position before 
resuming further editing. 

Filled Work Space Warning 

If CRE determines that a command string 
threatens to use up the remaining work space, it will 
stop echoing keyboard input characters to the printer 
and will echo instead the the BELL control character 
-causing the I/O data terminal to ring its bell as a 
warning. The user should respond by erasing part of 
it with the RUBOUT key. 

If CRE runs out of space during command 
execution, it will return the error message 

MEMORY FULL “xxx...xx$” 

where, again, xx...xx is a reproduction of the un¬ 
processed part of the command string. 

CRE Commands 

This section contains a summary of the individual 
commands which CRE is designed to recognize. Each 
command is described with a specification of its 
acceptable format and an explanation of its 
execution. Examples are also given. 
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Single Commands 

Pointer Control Commands 

BEGINNING 

Execution: Pointer repositioned to the beginning of 
the buffer. 

END OF BUFFER 

Format: Z 

Execution: Pointer repositioned to the end of the 
buffer. 

character step 

Format: nC 

Execution: Step pointer right (or left)* by n 
characters. 

LINE STEP 

Format: nL 

Execution: Step pointer down (or up) by n lines 

Reading the Input Tape 

APPEND 
Format: A 

Execution: Lines are read from the input file (con¬ 
tinuing from the last line) and appended to the end of 
the buffer. The operation continues until one of the 
following occurs: 

(1) End of file character detected (i.e., last line has 
been read). 

(2) 3/4 of the remaining available space has been 
filled. 

(3) 50 lines have been transferred. 

The pointer is repositioned to the beginning of the 
first appended line. In large memory systems, 
multiple appends may be used to bring additional 
lines into the buffer. 

Note: The keyboard BREAK key is ignored during 
execution of this command only. 

Deletion Commands 

DELETE 
Format: nD 

* A positive (unsigned) n indicates the direction of right or down; 

a negative n indicates left or up for all commands. 


Execution: n characters right (or left) adjacent to the 
printer are deleted. 

KILL 

Format: nK 

Execution: n lines right (or left) adjacent to the 
pointer are deleted. 

Text Insertion and Data Manipulation 

INSERT 
Format: lt€xt$ 

Execution: Typed text is inserted to left of present 
pointer position. The text may contain multiple lines, 

SAVE 

Format: nX 

Execution: Copy n lines adjacent to the pointer into a 
special SAVE area external to the buffer. The 
pointer position is not changed. Previous contents of 
the SAVE area are overwritten. CRE types CAN’T 
SAVE if there is insufficient room in the SAVE area 
and it does not save any lines. CRE clears the SAVE 
area if n=0 (zero). 

GET 

Format: G 

Execution: Equivalent to an INSERT, but using the 
present contents of the SAVE area as an implicit text 
argument. Note: SAVE and GET are especially 
useful in sequence as a copying mechanism - to 
MOVE text. 

CRE dynamically allocates the available RAM 
work space to its SAVE area, stack area, and the 
buffer or editing area. Once lines have been SAVE’d, 
they remain in the SAVE area indefinitely until the 
next SAVE command overwrites them. If many 
characters have been SAVE’d, the area available for 
the buffer will be proportionally reduced. The SAVE 
area is not automatically cleared by a GET com¬ 
mand. Several GET commands may be issued against 
the same SAVE area. It is good practice, therefore, to 
clear the SAVE area when it is no longer needed in 
order to make that area available to the buffer. This 
step is accomplished by typing OX (zero-X). 


If an attempt is made to save more lines than 
there is room for, CRE will type 

CAN’T SAVE 

and will not transfer any lines to the SAVE area. 
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FIND 

Format: FteoctS 

Execution: A search for the specified character 
sequence "text' occurs from the current pointer 
position toward the end of the buffer. It stops either 
when a match is first encountered or when the end of 
the buffer is reached. In the first case, the pointer 
ends positioned immediately after the matching 
string. In the latter case, a “CAN’T FIND” message 
is printed, and the pointer position is unchanged. 

SUBSTITUTE 

Format: S search text $ substitute text $ 

Execution: Operates as FIND does above (using 
search text as the search argument). However, on a 
match, the substitute text replaces the matching 
sequence - with the pointer positioned after the in¬ 
serted text. The substitute text must not be omitted 
from the ©ommand. 

Output Commands 

TYPE 
Format: nT 

Execution: Type the n lines adjacent to the current 
pointer. The pointer position remains unchanged. 

PUNCH 

Format: nP 

Execution: The n lines adjacent to the current pointer 
are written to the output tape and printed on the 
printer. The pointer position remains unchanged. 
The lines are not deleted from the buffer. 

WRITE and DELETE 

Format: nW 

Execution: n is treated as positive. The n lines at the 
beginning of the buffer are written to the output tape, 
printed on the printer, and also deleted from the 
buffer. The pointer ends up positioned at the 
beginning of the remaining buffer, 

END 

Format: E 

Execution: The entire buffer is written to the output 
tape and also printed on the printer. Any lines 
remaining on the input tape are then copied to the 
output tape and printed on the printer. Finally, if a 
teletypewriter is used, the 60 null trailer is punched 
out. CRE then reinitializes for a new editing session 
with buffer cleared and with the pointer positioned at 
the beginning of the work space. 


NULLS 
Format: N 

Execution: If a teletypewriter is used, 60 nulls are 
punched. Otherwise, this command is ignored. The 
pointer is not changed. 

Summary of CRE Commands 
and Control Characters 

A summary listing of the foregoing commands 
together with the meaning of each one is given in 
Table X. A summary of the special CRE control 
characters is given in Table XI. The CRE error 
messages are summarized in Table XII. 


Composite Commands and Nesting 

CRE also permits the user to specify composite 
commands. A composite command is a command 
string (one or more commands) enclosed within angle 
brackets (<...>). A command string may be 
preceded by a decimal number indicating the number 
of times that the string within the brackets should be 
executed. 


One composite command may include another. 
Thus, CRE permits the “nesting” of commands. For 
example, 

B5<3C4<DI $>L>{|;$ 

causes replacement of the 4th through the 7th 
characters in the first 5 lines in the buffer by spaces. 
The pointer ends positioned at the beginning of the 
sixth line. 

With nested commands, the user must be aware 
of the order in which commands will be executed and 
the number of times individual operations will occur. 
The following example should indicate the general 
algorithm. Other examples will be given later. 
Consider the command string 

a<b<CSj>c<d<e<CS2>CS3>CS4» 

where the lower case letters represent numbers and 
where each CSj, represents an elementary command 
string. Fig. 29 indicates CRE’s flow chart for the 
execution of this command string. It is derived by 
properly pairing the angle brackets in the string. 
Notice, for example, that CS 2 is executed a number 
of times equal to the product of a, c, d, and e. 
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Format 


TABLE X - CRE COMMAND SUMMARY 

Meaning 


B Move pointer to BEGINNING of buffer. 

Z Move pointer to END of buffer. 

nC Step pointer right (or left) by n CHARACTERS. 

nL Step pointer down (or up) by n LINES. 

A APPEND lines to end of buffer from input tape. 

Reposition pointer to beginning of APPENDed area. 

’ * nD DELETE n characters after (or before) pointer. 

nK KILL n lines after (or before) pointer. 

lrexf$ INSERT text at present pointer position. (Position pointer after it.) 

nX Save n lines after (or before) pointer. (Pointer position unchanged.) 

Clears the SAVE area if n = 0. 

G GET the last SAVEd lines and INSERT them. 

Ffexf$ FIND the first occurrence of text, searching from present pointer 

position toward end of buffer. If found, position pointer after the 
match. If not, type CAN'T FIND. 

S search text $ substitute text $ f\[^D search text and SUBSTITUTE substitute text 

for it. 

nT TYPE n lines after (or before) pointer. (No change in pointer location.) 

nP Output n lines after (or before) pointer. (Buffer and pointer remain unchanged.) 

nW WRITE (and delete from buffer) the first n buffer lines on the output type. 

(Pointer ends up at beginning of remaining buffer.) 

E END the editing session. Equivalent to an nW, with n equal to or 

greater than the number of buffer lines, followed by a copy of remaining 
input tape to output tape. If paper tape, terminate with NULL trailer. 

N If paper tape, punch 60 NULLs on output tape. 


TABLE XI - SUMMARY OF SPECIAL CRE CONTROL CHARACTERS 


(1) ESCAPE or ALT. MODE 


(2) LINE FEED 

(3) CARRIAGE RETURN 


(4) NULL 


(5) RUBOUTor DELETE 


(6) DC3 


(7) HORIZTAB 


(8) BREAK 


Echoed as $. 

Optional command separator. 

Required after a TEXT field. 

Two required at the end of a command string. 
Ignored on input. 

Inserted after CR on output. 

Line terminator character. 

Stored in buffer. 

Ignored on input. 

Set of six inserted after LF on tape output. 

Punch ON/OFF signal to CRE from user. 

Erases previous character in a command string. 
Ignored on tape input. 

End-of-file character. Inserted by user at end 
of a created file or read in from an existing 
input file. 

Echoed as 1 to 8 spaces when typed. 

Converted to 1 to 8 spaces on tape output. 

Can begin a command implying a previous INSERT. 
Pressing BREAK will terminate a long operation. 
Next, press RUBOUT or DELETE to get a prompt ^ 


Note: 

Within a command string, but not within a text field, CRE ignores any 
inserted spaces or CR' s. Spaces or CR's may be used to improve the 
readability of the command string, if desired. 
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TABLE XII - CRE ERROR MESSAGES 


Message 
LINE TOO LONG 

BAD COMMAND?? “XXX . . . X$" 

<BELL> 

MEMORY FULL "XXX , .. X$" 

CAN'T SAVE 
CANT FIND 

ITERATION STACK FAULT 


Meaning 

A line that CRE is attempting to TYPE has more than 
78 characters. 

CRE has found an invalid command in a command string. 
XXX ... X is that part of the string not executed. 

Filled work space warning. 

CRE ran out of work space during an execution. 

XXX ... X is the unprocessed part of the command string. 
There is not enough room in the SAVE area. 

The specified character sequence was not found between 
the pointer's previous position and the end of the buffer. 
CRE ran out of stack space during execution of a command 
string. May indicate improperly paired brackets in the string. 


To execute a nested command, CRE maintains a 
stack in part of the available work space. The 
amount of stack space required depends on the depth 
of nesting in the command, i.e., on the number of 
loops within loops, as in Fig. 29, which in turn 
depends on the depth of bracket-pairs-within- 
bracket-pairs in the command string. If CRE runs 
out of stack space during execution, it will issue the 
error message: 

ITERATION STACK FAULT. 


ENTER 



Fig. 29 — Execution of nested composite command. 


This error message is most likely to occur if the 
brackets in the command string are not paired 
properly. In particular, it occurs if a bracket is 
missing. 

Note that if the user fails to terminate a text 
string with the required ESC character, all sub¬ 
sequent characters until an ESC does occur will be 
treated as part of the presumed text string. Thus, it is 
quite possible that a missing ESC in a nested com¬ 
mand string could also result in the “improperly- 
paired-brackets” error message, ITERATION 
STACK FAULT. 

Horizontal Tabs 

CRE assumes an implicit horizontal tab stop 
after every eight character positions in a line. If the 
user types a HORIZ TAB character (CTRL and I) as 
part of a TEXT field, CRE will insert this character 
into its buffer, but it will echo back to the printer a 
sufficient number of spaces to reach the next implied 
tab stop. HORIZ TAB characters read from the 
input file are loaded into the buffer as is. On output, 
each HORIZ TAB buffer character is converted into 
the required niunber of spaces, extending the line 
length in the process. Thus, HORIZ TAB characters 
cannot appear on the output tape. The TAB 
character can be used to produce straight columns in 
a source file. 

Note: As a special case, CRE interprets a text 
beginning with a HORIZ TAB character as if an 
INSERT command had preceded it. 

Additional Note 

Normally, the INSERT of a non-existent text 
field (i.e., the command 1$) results in no operation. 
Further, it is normally illegal to precede an INSERT 
command with a numeric argument. However, the 
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specific command nl$ (combining the two) is legal. It 
causes the insertion of a single character whose 
ASCII decimal value is n (modulo 128). 

For example, lOIS will cause insertion of a LF 
character (hex OA). 


Using CRE 

In this section, information is given on the 
development and manipulation of a COSMAC file 
through use of the COSMAC Resident Editor (CRE). 
Imaddition, some useful common sequences are given 
to illustrate CRE’s data manipulation facilities. 

Loading and Operating CRE 

The following steps are required to use CRE: 

1. Load the program as follows: 

a. For a TI terminal in the LINE mode. 

1) Press RESET, then RUN U, then 
CR - get a *. 

2) Mount CRE program cassette and 
rewind it. 

3) Press LOAD/FF to advance to the 
first file. 

4) Press CONT/START to start reading 
the file. 

b. For a Teletype terminal in the LINE 
mode. 

1) Press RESET, then RUN U, then 
CR - get a *. 

2) Mount CRE tape in reader. 

3) Place the READER Control switch 
in the Manual position. 

4) Press START on the tape reader. 

2. Mount input file (if any) in reader. 

3. Mount a blank cassette for the output file. If 
paper tape, do not turn punch ON yet. 

4. Type $U(CR) to start CRE. 

5. CRE begins by typing asking user to 
identify the type terminal in use. In response, type P 
for a Teletype terminal or any other character for a 
TI terminal. 

6. CRE will then give the > prompt indicating 
that it is ready to accept commands. 


File Development and Manipulation 
Creating a File 

A file is created by a repeated sequence of the 
following steps: 

(1) File buffer from keyboard with sequence of 

insert’s. 

(2) WRITE buffer to output file. 


A single I command may take as an argument a text 
string of abritrary length. Thus, many lines may be 
inserted with a single I command. Each line is ter¬ 
minated by pressing the RETURN key. A typical 
INSERT will thus appear on the printer as 


I line 1 
line 2 


line n 


..Insert command and 1st line of 
.. text. 

..Additional lines 
..Additional lines 
..Additional lines 
..Additional lines 
..Last line of text 
..End of insert; double 
..ESCAPE 


because each CR is echoed as CR, LF. Such com¬ 
mands may be sequenced until the buffer is nearly 
filled. These sequences are then normally followed by 
an nW (WRITE) command or BnP, with n > the 
number of lines in the buffer. By use of the W 
command, the buffer is cleared after the WRITE to 
the output file and is ready for a new set of IN¬ 
SERT’S. 


The last line inserted should be followed by the 
insertion of a terminating dummy line consisting of 
the single character DC3 (CRTL and S), followed by 
the usual RETURN to assure proper tape format, as 
discussed earlier. 

If the output tape is a paper tape, a final N 
command will add the trailer of NULL’s. 


Adding to a File 

A section is added to an existing file by first 
copying the portion before the insert, and finally 
copying the portion after the insert. The first copy 
involves one or more APPEND’s followed by 
write’s, up to the APPEND which reads in the 
section of the input file which contains the insertion 
point. Note that appending to the end of a file may 
also be considered as an insertion just before the last 
DC3 terminating line. 
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Assuming the insert point is arbitrarily located 
within the buffer, several variations exist for adding 
text material. For any of these variations, the pointer 
must first be moved to the insert point. Then, a 
sequence of INSERT’S is made at that point, par¬ 
ticularly if the amount of the inserted material is 
small. Alternatively, one could SAVE all lines 
Following the pointer (with an nX, n sufficiently 
: large), delete them with an nK command, and then 
WRITE the data remaining in the buffer with an nW 
In sufficiently largeb The buffer then becomes empty 
. ‘ with all records preceding the addition written to the 
output tape. Additional INSERTs and WRITE s 
may now be made. Finally, a GET followed by a 
' WRITE will attach the material after the Insert 
point. Now if there is more unread material on the 
input file, the GET may be followed directly by an 
END command. This command will automatically 
copy the remaining input tape. 

In summary, one inserts material into an existing 
file by beginning with a copy sequence (a series of 
APPEND s followed by WRlTE’sb Then with the 
[)oinler |X)silioned properly, one may execiile nX nK 
nW (n sufficiently large). Now, one operates in the 
CHE ATE mode with INSERT'S followed by 
write’s. Finally a GET or GnW will complete the 
sequence. 

When appending to the end of a file, one has the 
alternative of removing, after the last APPEND, the 
dummy termination line via a Z-1K command string* 
Operation then is as in the CREATE mode* For this 
case, the final DC3 line must later be inserted to the 
end of the file. 


Deleting a Section in a File 

To delete a section in a file, first copy up to the 
deletion point, as previously discii^ed* Lines to be 
omitted may then be explicitly deleted from the buffer 
(by nK, with pointer properly positioned). If further 
lines to be deleted exist on the input file, further 
append’s are required. 

Note that the nP command causes a WRITE 
from the present pointer position. Thus, text may be 
implicitly deleted by moving the pointer past it and 
issuing an nP command (n positive). After the 
remainder of the buffer has been written, the com¬ 
mand string BnK (n sufficiently large) will erase the 
buffer. 


Moving a Section in a Fiie 

Assume that the file section to be moved is 
sufficiently small. If the movement is toward the end 
of the file, the following sequence may be used: 

(1) Copy input file up the section to be moved. 

(2) SAVE the section to be moved. Then 
DELETE it in the buffer. 

(3) Continue copying the input file up to the 
insertion point. 

(4) GET and WRITE the SAVE’d section. 

(5) Copy the remaining part of the input file. 

If the movement is toward the beginning of the file, 
one must first find the section to be saved, SAVE it, 
DELETE it, and then reinitialize the input file. 
Then, the sequence of steps 3, 4, and 5 above will 
effect the insertion. 

Note again that the P command may be used to 
WRITE from an arbitrary point in the buffer. Note 
also that the material thus written is not deleted from 
the buffer. 

Several complications of this simple procedure 
can occur. First, the material to be moved may 
overlap two APPEND’s. In this case, one does not 
SAVE until the second APPEND has been executed. 
Second, the material to be moved may consist of a 
substantial portion of the input file so large that it 
must first be copied on to a third temporary tape 
which might be called an “insertion file”. If this 
condition exists, the user should be sufficiently 
familiar with CRE so that he will be able to create 
and use this special temporary file. 

Modifying a Section in a File 

By now the reader should be reasonably familiar 
with the commands APPEND, PUNCH, WRITE, 
END, INSERT, SAVE, GET, and NULL’s. 

The most common use of CRE Is to modify the 
contents of a file at a given point (typically, to correct 
an error). To make such a modification, the user must 
first read that section of the file into the buffer. 
Normally, a copy of the initial portion of the file is 
necessary, up to the APPEND which brings into the 
buffer the section to be modified. Now, the remaining 
CRE commands are available to effect the 
modification. After the change is made, the process is 
terminated with an END command or a WRITE 
command as appropriate. 
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Some Command Examples 

Below are several examples of useful command 
sequences to further acquaint the reader with CRE’s 
data manipulation facilities. In each example a 
command string is given and followed by a short 
explanation of what it will do. For clarity all zeros are 
slashed (j^) to distinguish them from the letter O in 
these examples. 

(1) Assume the pointer is arbitrarily positioned within 
a line in the buffer; 

0LT Types the entire line leaving the pointer at its 
beginning. 

0TT Also types the entire line, but leaves the 
pointer unchanged. 

J^K Erases the portion of the line to the left of the 
pointer. 

K Erases the portion of the line to the right of 
the pointer. 

0LK Erases the entire line. 

For each of the following command sequences, it is 
assumed that n is sufficiently large, 

BnK Erases the entire buffer. 

0K Erases the entire SAVE area. 

BnT Prints the entire buffer. 

(2) Assuming the pointer is positioned at the 
beginning of a line in the buffer, 

nXnKZ-mLG 

will move the next n lines to m lines from the end of 
the buffer and erase them from their original position, 

(3) The command Bn<mCI $L >, for n sufficiently 


large, inserts a field of spaces in all lines, at a point m 
characters from the beginning of each line. 

(4) One can also scan the entire buffer with a FIND 
or SUBSTITUTE command by similarly using a 
sufficiently large numeric argument (called n below). 
The command will terminate when the end of the 
buffer is found with a CAN’T FIND message. For 
example: 

Bn<Sfieldmfi€ld2$> 

will replace all occurrences of fieldl by field2, 
Bn<F^eA:^$- mD> 

will delete all occurrences of text, if m=the length 
of the text field. 

Bn<Ftext$0LT> 

will print all lines containing text. 

Bn < F 

will delete all lines containing text. 

Bn<F;$ICR$> 

will break all lines containing semicolons into as 
many lines as there are semicolons - each terminating 
in a semicolon. (Note: In this case, any line originally 
ending in a semicolon will be followed by a “line” 
containing zero characters). 

Bn<S *TAB$L> 

will replace the first space in every line in the buffer 
by a horizontal tab control character. 

Bn<A50T50K> 

will perform the following n times: append in the next 
(first) section type it, and delete it from the buffer. 
This command string can be used to type a long file 
that can’t be held all at once in the buffer. It is 
particularly useful in typing the listing output file on 
the assembler. 
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Appendix A - 

CDS II CDP18S005 Backplane Wiring Schedule 


Pin 

Memory 

Address 

CPU 

I/O 

I/O 

Control 

Pin 

No. 


Latch and 


Decode 



No 



Bank 



[3] 




(1-9) 

Select (10) 

(12) 

(13) 

(14-24) 

(25) 


A 


BSE-P 

TPA-P 

TPA-P 

TPA-P 

TPA-P 

A 

B 

SPARE 

— 

TPB-P 

TPB-P 

TPB-P 

TPB-P 

B 

C 

DBO-P 

BS9-P 

DBO-P 

DBO-P 

DBO-P 

DBO-P 

C 

D 

DB1-P 

RNU-P 

DB1-P 

DB1-P 

DB1-P 

DB1-P 

D 

E 

DB2-P 

BS8-P 

DB2-P 

DB2-P 

DB2-P 

DB2-P 

E 

F 

DB3-P 

BS7-P 

DB3-P 

DB3-P 

DB3-P 

DB3-P 

F 

H 

DB4-P 

BS6-P 

DB4-P 

DB4-P 

DB4-P 

DB4-P 

H 

J 

DB5-P 

BS5-P 

DB5-P 

DB5-P 

DB5-P 

DB5-P 

J 

K 

DB6-P 

BS4-P 

DB6-P 

DB6-P 

DB6-P 

DB6-P 

K 

L 

DB7-P 

BS3-P 

DB7-P 

DB7-P 

DB7-P 

DB7-P 

L 

M 

AO-P 

BSD-P 

AO-P 

SELO-P 


AO-P 

M 

N 

A1-P 

BSF-P 

A1-P 

SEL1-P 

— 

A1-P 

N 

P 

A2-P 

A15-P 

A2-P 

SEL2-P 

N=4-P] 

A2-P 

P 

R 

A3-P 

A14-P 

A3-P 

SEL3-P 

N=5-P > [4] 

A3-P 

R 

S 

A4-P 

A12-P 

A4-P 

SEL4-P 

N=6-P3 

A4-P 

S 

T 

A5-P 

— 

A5-P 

SEL5-P 

— 

A5-P 

T 

U 

A6-P 

— 

A6-P 

SEL6-P 

— 

A6-P 

U 

V 

A7-P 

— 

A7-P 

SEL7-P 


A7-P 

V 

w 

MWR-N 

BSO-P 

MWR-N 

N=7-P 

N=7-P [5] 

— 

w 

X 

BSN-P [1] 

MBDS-N 

CPU PWR 

N=6-P 

EF4-N 

RUN-N 

X 

Y 

Vdd 

Vdd 

Vdd 

Vdd 

VpD 

VqD 

Y 

z 

GND 

GND 

GND 

GND 

GND 

GND 

z 

1 

TPA-P 

TPA-P 

DMAI-N 

N=1-P 

DMAI-N 

— 

1 

2 

TPB-P 

UA15-N 

DMAO-N 

N=2-P 

DMAO-N 

DMAO-N 

2 

3 

SPARE 

BSC-P 

ANY l/O-P 

N=3-P 


ANY l/O-P 

3 

4 

— 

BSB-P 

INT-N 

N=4-P 

INT-N 

RNU-P 

4 

5 

MRD-N 

BSA-P 

MRD-N 

MRD-N 

MRD-N 

MRD-N 

5 

6 

A12-P 

A12-P 

Q-P 

N=5-P 

Q-P 

Q-P 

6 

7 

A11-P 

A11-P 

SCO-P 

— 

SCO-P 

SCO-P 

7 

8 

A10-P 

A10-P 

SC1-P 

— 

SC1-P 

SC1-P 

8 

9 

A9-P 

A9-P 

CLEAR-N 

TLIO-N 

— 

CLEAR-N 

9 

10 

A8-P 

A8-P 

WAIT-N 

- 

- 

WAIT-N 

10 

11 

-5 V 

AO-P 

— 

— 

-5 V 

EX CLR-P 

11 

12 

EX WAIT 

A1-P 

EX CLK 

— 

— 

EX WAIT-P 

12 

13 

CLK OUT 

A2-P 

CLK OUT 

RESET-OP 

RESET-OP 

RESET-QP 

13 

14 


A3-P 

NO-P 

NO-P 

— 

NO-P 

14 

15 

- 

A4-P 

N1-P 

N1-P 

- 

N1-P 

15 

16 

RESET-OP 

A5-P 

N2-P 

N2-P 

— 

N2-P 

16 

17 

— 

A6-P 

EF1-N 

— 

EF1-N 

— 

17 

18 


A7-P 

EF2-N 

— 

EF2-N 

— 

18 

19 

Vq0 [2] 

BS2-P 

EF3-N 

— 

EF3-N 

EF3-N 

19 

20 

+12 V 

BS1-P 

EF4-N 

+12 V 

+12 V 

+12 V 

20 

21 

^DD 

Vdd 

^DD 

Vqd 

^DD 

Vdd 

21 

22 

GND 

GND 

GND 

GND 

GND 

GND 

22 
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Notes 

[1] B$N—P: No printed wires. Wire-wrap to user's choice, BSO through BSF. 

[2] Location 8 only. 

[3] Locations 19 and 20; all pins open except Vqq and GND. 

[4] Location 24 only (Disk interface). 

[5] Location 14 only (Terminal interface). 


Wire-Wrap Connections 


FtAM SELECT 

BSO-P 

10-W to 8-X 

ROM SELECT 

BS8-P 

10-E to 9-X 

TERM. SELECT 

SELO-P 

13-M to 14-M 

DISK SELECT 

SELO-P 

13-M to 24-M 

2-LEVEL I/O 

TLJO-N 

t3^9 to 13-22 (JumiMr) 

I/O DECODE 

RNU-P 

13-7 to 24-4 
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Appendix B - 

Instructions for Converting a Model 33 Teletype Terminal 
from Half-to-Full-Duplex Operation and from 
€0-mA to 20-mA Operation 


For a Teletype terminal connected for half-duplex 
operation, the following modifications can be made to 
convert it to full-duplex operation. 

1. Locate the black terminal strip in the back. See 
Fig. Bl. 

2, Move the brown/yellow and white/blue wires from 
pins 3 or 4 to pin 5. 

'For Teletype terminals, connected for 60-mA 
operation, the following modifications can be made 
for 20-mA operation. 

1. Move the violet wire from pin 8 to pin 9. 


CURRENT 

LIMITING 

RESISTOR 


¥ 


MODE 

SWITCH 


KEYBOARD 


TAPE 

RDR 


^ tntn 

fooo 

'uuuu 


PRINTER 


TAPE 

PUNCH 


I TERMINAL STRIP 


92CS-28I04 


2, Move the blue wire connected to the current source 
resistor (a flat green resistor with four tabs located to 
the right of the keyboard) from the 750-ohm tab to the 
1450-ohm tab. 

Fig. B2 gives the detailed interface circuitry 
between the CDS logic signals and the pin con¬ 
nections for the Teletype terminal in the full-duplex 
mode. Note particularly the isolation of the two 
Teletype (TTY) current loops. Also shown in Fig. B-2 
is the detailed interface circuitry between the CDS 
logic signals and the pin connections for an EIA 
RS232C type data terminal. 



Fig. B1 — Location of and connections to terminal strip for Model 33 Teletype 
data terminal showing connections for 20-mA full-duplex operation. 



Fig. B2 — Detail of CPU-Terminal Interface (See Appendix D). 


92CM-29393RI 
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Appendix C - 

Adding Teietype Remote Reader Controi 


A simple wiring change inside the conventional 
Model 33 Teletype terminal permits the paper-tape 
reader to be operated under control of an external 
COSMAC (program-derived) signal. The 
modifications are indicated in Fig. Cl. Two ad¬ 
ditional components must be appropriately mounted: 
an electronic relay and a switch. Wiring to be added is 
indicated by the bold line in the diagram. Note that 
^ the wiring connects the added switch and relay to 
^ points on the front mode switch and in the array of 
white plastic Molex connectors located in the back of 


the unit under the cover. Note also that one brown 
wire must be broken and reconnected as shown. 

The Terminal Interface module contains the logic 
necessary to permit a COSMAC program to control 
the paper-tape reader. With the added reader control 
switch in the remote or open position, a program may 
turn the reader on and off. In the manual or closed 
position, the reader can be controlled only manually, 
by means of the original reader control switch on the 
tape reader. Note particularly that this latter switch 
must also be activated (in the start position) in order 
for the remote program control to operate properly. 




^WOTOR^ 


READER 

CONTROL 

SWITCH 


CDS 

TERMINAL 

INTERFACE 

MODULE 


80 
40 
70 
SO¬ 
SO- 
10 O 


TRIP 

MAGNET 






TAPE 

PUNCH 


PRINTER 



TAPE 

READER 


KEYBOARD 

1 


ARRAY OF WHITE 
-PLASTIC MOLEX 
CONNECTORS 


TTY COMPONENT 
LAYOUT 


nir 

MODE SWITCH 


TTY TRIP 
MAGNET 


TO 

WHITE PLASTIC 
MOLEX PLUG 
IN POSITION 4 
(J4) 


YELLOW WIRE 


NOT MODIFIED 


EXISTING BROWN WIRE 


r 




BREAK 

THIS 

PATH 


-06 

-05 

-08' 

07 


(ADDED WIRING SHOWN AS BOLD LINES) 

I- 


TO TTY 


13, 


KEYBOARD 


TO TTY 
PRINTER 


'DC" 

SIDE 




WHITE PLASTIC 
MOLEX JACK 
INSIDE TTY 
IN POSITION 2 
(J2) 



ADDED 
READER 
CONTROL, 
SWITCH ' 


BROWN 

WIRE 


'^CONNECT TO ADDED 
wiring INSTEAD 


i7l 

± 


LABELED 

OPEN: "REMOTE" 
CLOSED:"MANUAL" 



WIRES 

NOT MODIFIED 


MODE SWITCH 
(FRONT VIEW) 


I___ I 

ADDED OPTO RELAY 


92CL-28203RI 


Fig. Cl — Teletypewriter modifications required to permit remote 
reader control. 
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Appendix D - 

Module Logic and Circuit Diagrams and Layout Diagrams 


MODULE Fig. No. Page No. 

CPU Module CDP18S102 

Logic and circuit diagram D1 84 

Layout diagram D2 84 

Control Module CDP18S103 

Logic and circuit diagram D3 85 

Layout diagram D4 85 

Address Latch and Bank Select Module CDP18S206 

Logic and circuit diagram D5 86 

Layout diagram D6 86 

I/O Decode Module CDP18S509 

Logic and circuit diagram D7 87 

Layout diagram D8 87 

ROM/RAM Module CDP18S401 

Logic and circuit diagram D9 88 

Layout diagram DIO 89 

4-Kilobyte RAM Module CDP18S205 

Logic and circuit diagram D11 90 

Layout diagram D12 90 

Terminal Interface Module CDP18S507 

Logic and circuit diagram D13 91 
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Fig. D1 — CPU module CDP18S102 logic and circuit diagram. 


Parts List for Fig. D1 {CDP18S102) 

Cl, C4 = 15 /iF, ± 20%, 20 volts 

C2, C3 = 22 pF, ± 20%, 20 volts 

R1 through R7 = 22 kilohms, ± 5%, 1/4 watt 

R8 = 22 megohms, ± 5%, 1 /4 watt 

U1 = CDP1802CD 

U2 = CD4011BE 

U3, U4, U5, U6 = CDP1856D 

Y1 = crystal, 2.00 MHz 



Fig. D2 - CPU moduie CDP18S102 
iayout diagram. 
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L Fig. D3 — Control module CDP18S103 logic and 
circuit diagram. 


\ ___ L 


J2 

Jl 

O O 

o o 


Parts List for Fig. D3 (CDP18S103) 

Cl =15 mF, ±20%, 20 volts 
CR1 = 1N914 



I—I 
L J 


J1 = connector, 34 pin 

J2 = connector, 20 pin 

R1 through R8 = 22 kilohm, ± 5%, 1/4 watt 

U1,U10 = CD4001BE 

U2 = CD4093BE 

U3, U11,U12 = CD4069BE 

U4, U5, U6 = CD4050BE 

U7 = CD4081BE 

U8, U18 = CD4013BE 

U9 = CD4071BE 

U13= CD4076BE 

U14 = CD4023BE 

U15 = CD4025BE 

U16 = CD4011BE 

U17 = CD4075BE 





Fig. D4 — Control module CDP18S103 
layout diagram. 


92CS-29403 
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+ V 


Pl-X 

Pl-D 


PI-18 

PI-17 

PI-16 

PI-15 

PI-14 

PI-13 

PI-12 

Pl-ll 

PI-1 


PI-21 
PI - Y 


Pl-22 
PI- Z 



PI-2 


Pl-P 

Pl-R 

Pl-S 

PI-6 


Pl-N 

Pl-A 

Pl-M 

PI-3 

PI-4 

PI-5 

Pl-C 

Pl-E 


92CM-29387 




I& 


Fig. D5 — Address latch and bank select module CDP18S206 logic and 
circuit diagram. 


Parts List for Fig. D5 (CDP18S206) 

Cl = 15iuF,20%, ±20 volts 
R1 = 22 kilohm, ± 5%, 1/4 watt 
U1,U4 = CDP1853D 
U2 = CDP1852D 
U3 = CD4001BE 



Fig. D6 — Address latch and bank 

select module CDP18S206 
layout diagram. 
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>---r 10^ 4011 s 




e 


16 

6 

wv 

1 

4 

■\Aj\i 


2 
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II 

WV 


9 

^VW 
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+V - 




CS2 




CSI 



U7 

CLK 
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-DflS-P 
"DB6-P 
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Fig. D7 — i/0 decode module CDP18S509 logic and 
circuit diagram. 


Parts List for Fig. D7 (CDP18S509) 

Cl =15juF,±20%, 20 volts 
R1 = 22 kilohms, ± 5%, 1/4 watt 
U1 = CD4023BE 
U2 = CD4011BE 

U3 = resistor module, 15 kilohms 
U4, U7 = CDP1852D 
U5 = CDP1853D 
U6 = CD4001BE 


Fig. D8 — I/O decode module 
CDP18S509 layout 
diagram. 


92CL-29390 
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U5 




92CL-29309 





Fig. D9 ROM/RAM module CDP18S401 logic and circuit diagram, 
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Parts List for Fig. D9 (CDP18S401) 

Cl, C2, C3 = 15 JUF, ± 20%, 20 volts 

R1, R2, R3 = 22 kilohms, ± 5%, 1/4 watt 

SI = SPOT 

U1 = CD4023BE 

U2 = CD4069BE 

U3 = CD4012BE 

.U4 = CDP1824D 

U5, U6 = CDP1856D 

U7, U9 = 2708 

U8 = Socket for Microterminal ROM 
Note: 

SI UP enables Microterminal ROM in U8. 

SI DOWN enables UT20 ROM's in U7 and U9. 




Fig. DIO - ROM/RAM module CDP18S401 
layout diagram. 


Link Connections: 


♦ 

♦ 


U7 

ROM 

U8 U9 

LK1 

LINKS 

LK2 

512 

512 

512 

short 


A 

1 k 

512 

1 k 

open 


B 

1 k 

1 k 

1 k 

open 


B 

1 k 

512 

512 

open 


A 

1 k 

1 k 

512 

open 


A 

512 

512 

1 k 

1 

short 


B 




U7 

U8 

U9 


ROM 







LK3 

LK4 

LK5 


2704 


B 

B 

B 


2708 


A 

A 

A 


CDP1832 

A or B 

A or B 

A or B 

CDP1834 

A 

A 

A 



The low-order U8 addresses are not 
contiguous with the U9 addresses 
and the second 512 addresses 
overlay the first 512 (wrap). 

* The low-order 512-byte addresses 
are not contiguous with the U9 
addresses and do not wrap. 
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tPI-XP 
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BANK SEL-P 
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rt 

s 
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II 

9 

15 

II 

ll 14 [ 7 

5 

3 

7 

14 
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^ (pi-e) - 


V V Y 

iZ K) 0.^ 



USA j. 
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KO 
Nl 


4 


5 
0 
7 

CLA CLB 




19 


CLA CLB 
NO 
Nl 
NE 


U6A 

CDPI653 


-U4B,D- 

-U3B,D- 

■ U2B,D- 
-Ul B,D - 

■usa^o- 

- U70.O- 

■ U5B,{>' 
-U6B,D- 
-UBC,E- 
-U4C,E- 
-U2C.E- 

■ UIC.E- 
'UeC.E- 
-U5C,E- 

- U7C,E- 

- U3C.E- 


R2 

'—vw- 


VdD^ 


Rl 

-AAA^ 


R4 

-AAA/- 


R3 


vv 


32-PACKAGE RAM MATRIX 


lOBuC 


12 QuC 14 B,C 


ieB,C 


D£jW Q,E|I6 [ 


+ 5 V 
- 


15/iF 

Ci=t±g0% 
^ 20 V 


i5g,C 


3I± 

CA" 

C5 

r 0.1/.F 

[=±00 % 
r - 20 % 

50V 

—►PI-2I<Y 

-1* *- \/ 


Vdd 


I3B,C 


ue^c 


PB.O 


IM. 


I3P>E 


t9D>E 


^R5 

>22 kfi 


>R6 <R7 

>22 kn S22kfl 


>R8 
>22 kn 


UIA 

CDPI056 




U2A 

CDP 1856 


IF 

tz 

13 1 


0. 

a 

r Jl 




a 

o 


? 2 ^ 

2 j 

□L £; J 

L £ 




'h 


Fig. D11 - 4-kiiobYte RAM module CDP18S205 logic and circuit diagram. 


92CL-29386 


Parts List for Fig. D11 (CDP18S205) 

Cl = 15/iF, ±20%, 20 volts 
C2, C3, C4, C5 = 0.1 +80%, -20%, 50 volts 

Rl through R8 = 22 kilohms, ± 5%, 1/4 watt 
UIA, U2A = CDP1856D 
U1B through U8B 
U1C through U8C 
U1D through U8D 
U1E through U8E 
U3A = CD4069BE 
U5A, U6A = CDP1853D 
U8A, U9A = CD4050BE 


CDP1822 


i(] 




2 LZ3 


7^ 








U 

U 

U 

U 

U 

U 

U 

U 

1 
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7 
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E 
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E 

E 

E 
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U 

U 
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U 

U 

U 
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2 
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4 

5 

6 

7 

a 
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0 

D 

D 

D 

D 
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u 
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u 
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92CS-29399 


Fig. D12 — 4-kilobyte RAM module 

CDP18S205 layout diagram. 
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+ 12 V 


(PI-13) 

(Pl-C) 

(Pl-M) 

(Pl-B) 

(Pl-W) 

'■(PI-5) 

(pr-L) 

(Pl-K) 


(Pl-X) 



U3 


Parts List for Fig. D13 (CDP18S507) 

Cl, C2, C4 = 15 ± 20%, 20 voits 

C3 = 33jliF,± 20%, 50 volts 
CR1, CR2, CR3, CR4 = 1N914 
J1, J2 = connector 
R1, R3 = 22 kilohms, ± 5%, 1/4 watt 
R2 = 910 ohms, ± 5%, 1/4 watt 
R4, R5 = 470 ohms, ± 5%, 1/4 watt 
R6, R7 = 10 kilohms, ±5%, 1/4 watt 
R8 = 4.3 kilohms, ± 5%, 1/4 watt 
R9 = 560 ohms, ± 5%, 1/4 watt 
U1 =CD4013BE 
U2 = CD4066AE 
U3 = CD4049BE 
U4 = CD4073BE 
U5 = CA324E 







U2 '1^ 



O 

_ / 

92CS-29398 


Fig. DM — Terminal interface module 
CDP18S507 layout diagram. 
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DISP 

MA-P 






Fig. D15 — Display board logic and circuit diagram. 


Parts List for Fig. D15 

Cl = IBjkF, ±20%, 20 volts 

CR1, CR2, CR3, CR4, CRB, CRB = light-emitting diodes 

J1 = connector, 34 pin 

SI, S2, SB, SB = momentary action 

S3, S4 = SPOT 

U1, U2, U3, U4, U12, U13 = decoder driver 
UB, UB, U7, U8, U9, U10 = 7-segment display 
U11 = CD40B0BE 


92CS*?9405 


Fig. DIG — Display board 
layout diagram. 
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004 

□16 


DOS 

DI7 


006 

CSE 

cst 

D07 


ITT!: 


Voo- 


UI2 

DATA OUT 
SAME 
AS 

ABOVE 


Vss 

zAig- 


SR 


CLK 

DOO 


CLR 

DOl 


DIO 

D02 


Dll 

D03 

D04 

UlO 

INPUT 
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DI2 

□13 


LUr loO^ 

DOS 
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D06 


DIS 

DOT 


DI6 
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DI7 


csi 

J 121. 
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(JI-4) 

(PI-10) 

(JI-9) 

(JI-IO) 
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I I' 
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92CS-29406 


Fig. D17 — Disk interface module CDP18S813 logic and 
circuit diagram. 

Parts List for Fig. D17 

Cl = 15 juF,±20%, 20 volts 

J1 = connector, 50 pin 

R1 = 22 kilohms, ± 5%, 1/4 watt 

U1,U2, U3, U5 = CA3083 

U4, U6 = CD4069BE 

U7 = resistor module, 3.3 kilohms 

U8, U9 = resistor module, 2.2 kilohms 

U10, U11,U12 = CDP1852D 

U13 = CD4081BE 

Note: 

Cable connector should be 
aligned with arrow on J1. 

Fig. D18 — Disk interface module CDP18S813 
layout diagram. 
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100 V- 


115 V- 


220 V- 


240 V- 



Parts List for Fig. D19 

Cl = 2500 iiF, 25 volts 

C2, C6 = 500 juF, 16 volts 

C3, C4, C5 = 7500 juF, 15 volts 

C7 = 1000 pF, 100 volts 

C8 = 3600 juF, 35 volts 

C9 = 330 juF, 25 volts 

CR1, CR2, CR7, CRB = A14F, 1 A 

CR3, CR4. CR5. CR6 = A15F, 3 A 

Q1,Q2 = 2N6102 

Q3 = 2N5492 

R1 = 510 ohms, ± 5%, 1/2 watt 
R2, R3 = 0.1 ohm, ± 10%, 5 watts 
R4 = 24 ohms, ± 5%, 2 watts 
R5 = 150 ohms, ±5%, 1/2 watt 
R6, R8 =100 ohms, ± 5%, 1/4 watt 
R7 = 220 ohms, ± 5%, 1/4 watt 
R9 = 360 ohms, ± 5%, 1/2 watt 
RIO = variable, 0-1000 ohms 
R11 = 1300 ohms, ± 1%, 1/4 watt 
R12 = 1000 ohms, ± 5%, 1/4 watt 
R13 = 100 ohms, ± 5%, 1/2 watt 
R14 = 1200 ohms, ± 5%, 1/2 watt 
U1 = LM320T-5.0 
U2 = 198658-1 
U3 = CA723CE 

T1 = Deltona #766-K29B, 50/60 Hz, input -100 to 240 volts 
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Appendix E - 

Instruction Summary for RCA CDP1802 COSMAC Microprocessor 


The COSMAC instruction summary is given in the 
tabulations below. Hexadecimal notation is used to 
refer to the 4-bit binary codes. 

In all registers bits are numbered from the least 
significant bit (LSB) to the most significant bit (MSB) 
starting with 0. 


R(W).0: Lower-order byte of R(W) 
R (W). 1: Higher-order byte of R (W) 


Operation Notation 
M(R(N))^D;R(N) + 1 


R(W): Register designated by W, where W=N or This notation means: The memory byte pointed toby 
X, or P R (N) is loaded into D, and R (N) is incremented by 1. 

INSTRUCTION SUMMARY 

Register Operations by Class of Operation 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

INCREMENT REG N 

INC 

IN 

R(N)+1 

DECREMENT REG N 

DEC 

2N 

R(N) -1 

INCREMENT REG X 

IRX 

60 

R(X) +1 

GET LOW REG N 

GLO 

8N 

R(N).(>>D 

PUT LOW REG N 

PLO 

AN 

D->R(N).0 

GET HIGH REG N 

GHI 

9N 

R(N).1^D 

PUT HIGH REG N 

PHI 

BN 

D->-R(N).1 


Memory Reference 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

LOAD VIA N 

LDfsl 

“or] 

M(R(N))->D; FOR N NOT O 

LOAD ADVANCE 

LDA 

4N 

M(R(N)KD;R(N) +1 

LOAD VIA X 

LDX 

FO 

M(R(X))^D 

LOAD VIA X AND ADVANCE 

LDXA 

72 

M(R(X))->D;R(X) +1 

LOAD IMMEDIATE 

LDI 

F8 

M(R(P))->-D;R(P) + 1 

STORE VIA N 

STR 

5N 

D^-M(R(N)) 

STORE VIA X AND 
DECREMENT 

STXD 

73 

D->M(R(X));R(X) -1 


Logic Operations'^ 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

OR 

OR 


FI 

M(R(X)) OR D->D 

OR IMMEDIATE 

ORI 


F9 

M(R(P)) OR D^D;R(P) +1 

EXCLUSIVE OR 

XOR 


F3 

M(R(X)) XOR D^D 

EXCLUSIVE OR IMMEDIATE ! 

XRI 


FB 

M(R(P)) XOR D^D;R(P) +1 

AND 

AND 


F2 

M(R{X)) AND D^D 

AND IMMEDIATE 

ANl 


FA 

M(R{P)) AND D^D;R(P) +1 

SHIFT RIGHT 

SHR 


F6 

SHIFT D RIGHT, LSBIDKDF, 
(H-MSB(D) 

SHIFT RIGHT WITH 

CARRY 

RING SHIFT RIGHT 

SHRC ■ 

RSHR 

1 

76^ 

SHIFT D RIGHT, LSB(D)^-DF, 
DF^-MSB{D) 

SHIFT LEFT 

SHL 


FE 

SHIFT D LEFT, MSB(D)^-DF, 
O^LSB(D) 

SHIFT LEFT WITH 

CARRY 

RING SHIFT LEFT 

SHLC ' 
RSHL ^ 

1 

7E^ 

SHIFT D LEFT, MSB(D)^DF, 
DF^LSB(D) 


♦NOTE: THIS INSTRUCTION IS ASSOCIATED WITH MORE THAN ONE 
MNEMONIC. EACH MNEMONIC IS INDIVIDUALLY LISTED. 
♦♦NOTE: THE ARITHMETIC OPERATIONS AND THE SHIFT INSTRUCTIONS 
ARE THE ONLY INSTRUCTIONS THAT CAN ALTER THE DF. 
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Arithmetic Operations*^ 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

ADD 

ADD 

F4 

M(R(X)) +D^DF, D 

ADD IMMEDIATE 

ADI 

FC 

M(R(P) +D->DF, D;R(P) +1 

ADD WITH CARRY 

ADC 

74 

M(R(X)) +D +DF^-DF, D 

ADD WITH CARRY 

ADCI 

7C 

M(R(P) +D +DF->-DF, D 

IMMEDIATE 



R(P) +1 

SUBTRACT D 

SD 

F5 

M{R(X))-D^DF, D 

SUBTRACT D IMMEDIATE 

SDI 

FD 

M(R(P))-D^DF,D;R(P) +1 

SUBTRACT D WITH 

SDB 

75 

M(R(X))-D-(NOTDF)-^DF;D 

BORROW 




SUBTRACT D WITH 

SDBI 

7D 

M(R(P))-D-(NOT DF)^-DF, D; 

BORROW, IMMEDIATE 



R(P) +1 

SUBTRACT MEMORY 

SM 

F7 

D-M(R(X))^DF, D 

SUBTRACT MEMORY 

SMI 

FF 

D-M(R(P))^DF, D; 

IMMEDIATE 



R(P) +1 

SUBTRACT MEMORY WITH 

SMB 

77 

D-M(R(X))-(NOT DF)-»-DF, D 

BORROW 




SUBTRACT MEMORY WITH 

SMBI 

7F 

D-M(R(P))-(NOT DF)^-DF, D 

BORROW, IMMEDIATE 



R(P) +1 


Branch Instructions — Short Branch 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

SHORT BRANCH 

BR 

30 

M(R(P))^R(P).0 

NO SHORT BRANCH 

NBR 

38^ 

R(P) +1 

(SEE SKP) 




SHORT BRANCH IF D=0 

BZ 

32 

IF D=0, M(R(P))-'R(P).0 




ELSE R(P) +1 

SHORT BRANCH IF 

BNZ 

3A 

IF D NOTO, M(R(P)) »R(P).0 

D NOTO 



ELSE R(P) +1 

SHORT BRANCH IF DF = 1 

BDF 

1 



SHORT BRANCH IF POS 

BPZ 

► 

33^ 

IF DF=1, M(R(P))->R(P).0 

OR ZERO 




ELSE R(P) +1 

SHORT BRANCH IF EOUAL 

BGE 

1 



OR GREATER 




SHORT BRANCH IF DF=0 

BNF ] 

3B^ 

IF DF=0, M(R(P))->R(P).0 

SHORT BRANCH IF MINUS 

BM 



ELSE RIP) +1 

SHORT BRANCH IF LESS 

BL J 



SHORT BRANCH IF 0=1 

BQ 

31 

IF 0=1, M(R(P))^R(P).0 




ELSE RIP) 

SHORT BRANCH IF 0=0 

BNQ 

39 

IF 0=0, MIRIP)) -R(P).0 




ELSE RIP) +1 

SHORT BRANCH IF EFl 1 

B1 

34 

IF EFl 1,M(R(P)) -RIP) 0 




ELSE RIP) M 

SHORT BRANCH IF EF1 0 

BNl 

3C 

IF EFl 0, MIR(P)) -HIPI.O 




ELSE RIP) ^ 1 

SHORT BRANCH IF EF2 1 

B2 

35 

IF EF2=1,M(R(P)) -RIPI.O 




ELSE RIP) +1 

SHORT BRANCH IF EF2=0 

BN2 

3D 

IF EF2=0, M(R(P)) 'R(P).0 




ELSE RIP) +1 

SHORT BRANCH IF EF3=1 

B3 

36 

IF EF3=1, MIR(P)) 'R(P).0 




ELSE RIP) +1 

SHORT BRANCH IF EF3=0 

BN3 

3E 

IF EF3=0, M|R(P))--R(P).0 




ELSE RIP) +1 

SHORT BRANCH IF EF4=1 

B4 

37 

IF EF4=1,M|R(P))->-R(P).0 




ELSE R(P)+1 

SHORT BRANCH IF EF4=0 

BN4 

3F 

IF EF4=0, M(R(P))-R(P).0 




ELSE RIP) +1 
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Branch Instructions — Long Branch 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

LONG BRANCH 

LBR 

CO 

M(R(P)KR(P).1 

M(R(P) +1)->R(P).0 

NO LONG BRANCH 
(SEE LSKP) 

NLBR 

C8^ 

R(P) +2 

LONG BRANCH IF D=0 

LBZ 

C2 

IF D=0, M(R(P))^R(P).1 

M(R(P) +1)->-R(P).0 
ELSE R(P) +2 

LONG BRANCH IF D NOT 0 

LBNZ 

CA 

IF D NOT 0, IVI(R(P))->- 
R(P).1 

M(R(P) +1)^ 
R(P).0 

ELSE R(P) +2 

LONG BRANCH IF DF=1 

LBDF 

C3 

IF DF = 1, M(R(P))->-R(P).1 
M(R(P) +!)->■ 

R(P).0 

ELSE R(P) +2 

LONG BRANCH IF DF=0 

LBNF 

CB 

IF DF=0, M(R(P))->R(P).1 
M(R(P) +1)^ 

R(P).0 

ELSE R(P) +2 

LONG BRANCH IF 0=1 

LBO 

Cl 

IF Q=1, M(R(P))->R(P).1 

M(R(P) +1)->-R(P).0 
ELSE R(P) +2 

LONG BRANCHJF 0=0 

LBNO 

C9 

IF Q=0, M(R(P))^R(P).1 
M(R(P) +!)-> 

R(P).0 

ELSE R(P) +2 


Skip Instructions 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

SHORT SKIP 

SKP 

38^ 

R(P) +1 

(SEE NBR) 




LONG SKIP 

LSKP 

C8^ 

R(P) +2 

(SEE NLBR) 




LONG SKIP IF D=0 

LSZ 

CE 

IF D=0, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF D NOT 0 

LSNZ 

C6 

IF D NOT 0, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF DF=1 

LSDF 

CF 

IF DF=1, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF DF=0 

LSNF 

C7 

IF DF=0, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF 0=1 

LSO 

CD 

IF 0=1, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF 0=0 

LSNO 

C5 

IF 0=0, R(P) +2 

ELSE CONTINUE 

LONG SKIP IF IE=1 

LSIE 

CC 

IF IE=1, R(P) +2 

ELSE CONTINUE 


♦NOTE: THIS INSTRUCTION IS ASSOCIATED WITH MORE THAN ONE 
MNEMONIC. EACH MNEMONIC IS INDIVIDUALLY LISTED. 
♦♦NOTE: THE ARITHMETIC OPERATIONS AND THE SHIFT INSTRUCTIONS 
ARE THE ONLY INSTRUCTIONS THAT CAN ALTER THE DF. 
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Control Instructions 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

IDLE 

IDL 

00 

WAIT FOR DMA OR 

INTERRUPT; M(R(0))^BUS 

NO OPERATION 

NOP 

C4 

CONTINUE 

SET P 

SEP 

DN 

N->P 

SET X 

SEX 

EN 

N-^X 

SET Q 

SEO 

7B 

1^0 

RESET Q 

REO 

7A 

(HQ 

SAVE 

SAV 

78 

T^M(R(X)) 

PUSH X,PTO STACK 

MARK 

79 

(X,P)^T;(X,P)-^M(R(2)) 

THEN P'>X;R(2)-1 

RETURN 

RET 

70 

M(R(X))^(X,P);R(X) +1 

HIE 

DISABLE 

DIS 

71 

M(R(X)H(X,P);R(X) +1 

CHIE 


Input-Output Byte Transfer 


INSTRUCTION 

MNEMONIC 

OP 

CODE 

OPERATION 

OUTPUT 1 

OUT 1 

61 

M(R(X))-8US; R(X) +1; 

N LINES = 1 

OUTPUT 2 

OUT 2 

62 

M(R(X))^BUS;R(X) +1; 

N LINES = 2 

OUTPUT 3 

OUT 3 

63 

M(R(X))->BUS;R(X) +1; 

N LINES 3 

OUTPUT 4 

OUT 4 

64 

M(R(X)) ►BUS;R(X) M; 

N LINES - 4 

OUTPUT 5 

OUT 5 

65 

M(R(X))^BUS;R(X) +1; 

N LINES - 5 

OUTPUT 6 

OUT 6 

66 

M(R(X))->BUS; R(X) +1; 

N LINES -6 

OUTPUT 7 

OUT 7 

67 

M(R(X))-^BUS; R(X) +1; 

N LINES = 7 

INPUT 1 

INP 1 

69 

BUS^M(R(X));BUS->D; 

N LINES = 1 

INPUT 2 

INP 2 

6A 

BUS-^M(R(X));BUS-^D; 

N LINES = 2 

INPUT 3 

INP 3 

6B 

BUS->M(R(X));BUS->D; 

N LINES = 3 

INPUT 4 

INP 4 

6C 

BUS^M(R(X));BUS-^D; 

N LINES = 4 

INPUT 5 

INPUT 6 ^ 

INP 5 

6D 

BUS^M(R(X));BUS->D; 

N LINES =5 

INP 6 

6E 

BUS->M(R(X));BUS-^D; 

N LINES = 6 

INPUT 7 

- 

INP 7 

6F 

BUS^M(R(X));BUS-D; 

1 N LINES = 7 


♦NOTE- THIS INSTRUCTION IS ASSOCIATED WITH MORE THAN ONE 
MNEMONIC. EACH MNEMONIC IS INDIVIDUALLY LISTED. 
♦♦NOTE THE ARITHMETIC OPERATIONS AND THE SHIFT INSTRUCTIONS 
ARE THE ONLY INSTRUCTIONS THAT CAN ALTER THE DF. 







































LEAST SIGNIFICANT HEX DIGIT 
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0 

1 

2 

3 

4 

5 

6 

7 

8 
9 
A 
B 
C 
D 
E 
F 


Appendix F - 
ASCII - Hex Table 



MOST 

SIGNIFICANT 

HEX 

DIGIT 



0 

1 

2 

3 

4 

5 

6 

7 

NUL 

DLE 

SP 

0 

@ 

P 

N. 

P 

SOH 

DCl 

1 

1 

A 

Q 

a 

q 

STX 

DC2 


2 

B 

R 

b 

r 

ETX 

DC3 

# 

3 

C 

S 

c 

s 

EOT 

DC4 

$ 

4 

D 

T 

d 

t 

ENQ 

NAK 

% 

5 

E 

U 

e 

u 

ACK 

SYN 

5 

6 

F 

V 

f 

V 

BEL 

ETB 

y 

7 

G 

w 

g 

w 

BS 

CAN 

( 

8 

H 

X 

h 

X 

HT 

EM 

) 

9 

I 

Y 

i 

y 

LF 

SUB 

* 

* 

J 

z 

j 

z 

VT 

ESC 

+ 


K 

[ 

k 

{ 

FF 

FS 

/ 

< 

L 

\ 

1 

1 

1 

CR 

GS 

- 

- 

M 

] 

m 

} 

SO 

RS 

• 

> 

N 

+ 

n 

% 

SI 

US 

/ 

7 

0 


0 

DEL 


NOTES: 

(1) Parity bit in most significant hex digit not included. 

(2) Characters in columns 0 and 1 (as well as SP and DEL) 
are non-printing. 

(3) Model 33 Teletypewriter prints codes in columns 6 and 
7 as if they were column 4 and 5 codes. 
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\n 

0000 

0000 

0000 

0000 

00.00 

0000 

0000 

0000 

0000 

0000 

0000 

^0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

8000 

8000 

8002 

8005 

8005 

8005 


Appendix G - UT20 Listing 


7100; 

F880B0; 


0001 

0002 .. UT20 IS A UTILITY PROGRAM USED TO ALTER 
0003 .. MEMORY, DUMP MEMORY, AND BEGIN PROGRAM 
OOOA .. EXECUTION AT A GIVEN LOCATION. THE COMMANDS 
0005 .. ACCEPTED ARE SPHHHH (BEGIN EXECUTION AT THE 
0006 .. SPECIFIED LOCATION WITH RO AS PROGRAM 
0007 .. COUNTER), IMHHHH DATA (PUT DATA AT SPECIFIED 
0008 .. LOCATION), AND 7MHHHH HHHH (OUTPUT DATA 
0009 .. FROM SPECIFIED LOCATION FOR SPECIFIC COUNT). 
0010 .. AT THE BEGINNING OF A COMMAND ALL CHARACTERS 
0011 .. ARE IGNORED UNTIL A ?, !, OR S IS 

0012 .. ENCOUNTERED. IN THE ?M AND !M COMMANDS NON 
0013 .. HEX CHARACTERS ARE IGNORED AFTER M UNTIL A 
0014 .. HEX IS READ, THEN THE FIRST NON HEX 
0015 .. CHARACTER MUST BE A SPACE. NON HEX 
0016 .. CHARACTERS BETWEEN HEX PAIRS OF THE DATA IN 
0017 .. THE !M COMMAND ARE IGNORED EXCEPT FOR CR, 

0018 .. SEMICOLON, AND COMMA. 

0019 .. $L LOADS DATA (WRITTEN IN UT20 FORMAT) FROM 
0020 .. FLOPPY DSK INTO MEMORY. THERE ARE 77 TRACKS 
0021 .. AVAILABLE ON A DISKETTE (TRACK 0-76). 

0022 .. LOADING STOPS IF THE EOF (DC3) IS DETECTED. 
0023 .. THE BAUD RATE OF UT20 IS DEPENDENT UPON THE 
0024 .. TERMINAL BEING USED. A CR OR LF IS ENTERED 
0025 .. AT THE BEGINNING TO SPECIFY THE APPROPRIATE 
0026 .. DELAY BETWEEN BITS. UT20 WILL ECHO 
0027 .. CHARACTERS IF A CR IS CHOSEN AS THE 
0028 .. TIMING CHARACTER. ECHOING WILL NOT TAKE 
0029 .. PLACE IF A LF IS INPUT AS THE TIMING 
0030 .. CHARACTER. 

0031 .. UT20, AT INITIATION, STORES ALL REGISTERS 

0032 .. BETWEEN WRAM-32 AND WRAM IF IT FINDS RAM 
0033 .. THERE (BUT RO, Rl, AND R4.1 ARE CLOBBERED). 
0034 .. ?R CAN BE USED TO TYPE THE CONTENTS OF THE 16 
0035 .. REGISTERS (RO-RF). R0,R1,R4.1 WILL BE 
0036 .. TYPED AS X'S (DON'T CARE). 


0037 

PTER=#00 


..AUXILIARY FOR MAIN ROUTINE 

0038 

CL=«01 


. .CLOBBERED 

0039 

ST=ff02 


..STACK POINTER ONLY REFERENCE TO RAf 

0040 

SUB = /lf03 


..SUBROUTINE PROGRAM COUNTER 

0041 

PC=#05 


..MAIN PROGRAM COUNTER 

0042 

SWITCH=CL 


..DISTINGUISHES BETWEEN ?M AND !M 

0043 

DELAY=#OC 


..DELAY ROUTINE PROGRAM COUNTER 

0044 

ASL=#OD 


..HEX ASSEMBLY REGISTER ON INPUT; 

0045 



..AUX FOR HEX OUTPUT 

0046 

CNTER=ASL 


..USED TO COUNT OUTPUT BYTES 

0047 

AUX=#OE 


..AUX.1 HOLDS BIT-TIME CONSTANT 

0048 

CHAR = AfOF 


..CHAR.1 HOLDS I/O BYTE 

0049 

WRAN=#8C1F 

..REGISTERS STORED IN RAM 

0050 

LOADER=#8400 

..LOCATION LOADER PROGRAM 

0051 

. • 



0052 

.. ENTER IN 


RO 

0053 




0054 

0RG#8000 ..UT20 STARTS AT 

0055 



..M(8000) 

0056 

DIS^ 

#00 ..P=X=0 

0057 

LDI 

A 

.1(UT20) ;PHI RO ..HOLDS HIGH BIT 

0058 



..AFTER FINGER OFF 

0059 

.. MAY TRY 

TO GO TO 8000, NOT 0000 

0060 

.. UNTIL FINGER IS OFF BUTTON 
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8005 


0061 

* « 




8005 


0062 


THE 

FOLLOWING WRITES REGISTER CONTENTS INTO 

8005 


0063 


WRAM-32 THRU WRAM IF IT 

EXISTS. WRAM-34 IS 

8005 


0064 

V • 

ASSUMED NOT TO BE RAM (ELSE ROUTINE OVERRUNS). 

8005 

/ 

0065 



' 


8005 


0066 





8005 

F88CB1; 

0067 



LDI A.KWRAM) ;PHI CL ..CL IS CLOB- 

8008 


0068 




..BERED 

8008 

F81EA1; 

0069 



LDI A.O(WRAM-I) ;PLO 

CL ..SET UP WHERE RF.O 

800B 


0070 




..IS TO GO, MINUS 1 

800B 

F8A0B4; 

0071 



LDI «A0 ;PHI R4 

..R4.1 STORES A 

800E 

• 

/ 

0072 




..MODIFIED INSTRUC. 

800E 

El; 

0073 



SEX CL 


8-pOF 

F8D051; 

0074 

L00P2: 

LDI #D0 ;STR CL 

..SET UP SEP INSTR. 

8012 


0075 




..FOR RETURN 

8012 

F3; 

0076 



XOR 

-.CHECK IT WROTE 

8013 

3A29; 

0077 



BNZ UT20 


8015 

21; 

0078 



DEC CL 

..PREPARE FOR MODI- 

8016 


0079 




..FIED INSTRUCTION 

8016 

94FC70; 

0080 



GHI R4 ;ADI #70 

..IN THE 90'S? 

8019 

3310; 

0081 



BDF*+#04 


801B 

FC21; 

0082 



ADI #21 

..NO, 8N -> 9N 

801D 

FC7F; 

0083 



ADI #7F 

..YES, 9N -> 8(N-1) 

801 F 

B451; 

0084 



PHI R4 ;STR CL 

..SET MODIFIED 

8021 

f 

0085 




..INSTRUC INTO RAM 

8021 

01; 

0086 



SEP CL 

..EXECUTE INSTRUCS 

8022 

# 

0087 




..(80-9F) 

8022 

73; 

0088 



STXD 

..STORE RESULT RAM 

8023 

21; 

0089 



DEC CL 

..& BACK UP FOR 

802A 

94FB90; 

0090 



GHI R4 ;XRI#90 

..CK IF STORAGE DONE 

8027 

3A0F; 

0091 



BNZ L00P2 

..NEXT BYTE 

8029 

/ 

0092 

• « 




8029 

90B5B3; 

0093 

UT20 

• 

• 

GHI RO ;PHI PC ;PHI 

SUB ..#80->PC.1 & SUB.1 

802C 

F830A5; 

0094 



LDI A.0(UT20A) ;PLO 

PC 

802F 

05; 

0095 



SEP PC 


8030 

E5; 

0096 

UT20A: 

SEX PC 


8031 

7155; 

0097 



DIS,#55 

..NOTE PC=5 ASSUMED 

8033 

6101; 

0098 



OUT 1,#01 

..SELECT RCA GROUP 

8035 

F88CB2; 

0099 



LDI A.KWRAM) ;PHI 

ST ..SET STACK POINTER 

8038 

F800A2; 

0100 



LDI#00 ;PLO ST 


803B 

/ 

0101 




..TO M(8C00), ONLY 

803B 

/ 

0102 




..RAM USED 

803B 

F8FEA3; 

0103 



LDI A.O(TIMALC) ;PLO 

SUB..READ ONE CHAR 

803E 

; 

0104 




..TO SET TIMER 

803E 

D3; 

0105 



SEP SUB 


803F 


0106 

* M 




803F 


0107 

* « • 

INITIATION NOW DONE 


803F 


0108 

• • 




803F 

F89CA3; 

0109 

START: 

LDI A.0(TYPE5D) ;PLO 

SUB 

8042 

F881B3; 

0110 



LDI A.1<TYPE5D) ;PHI SUB 

8045 

0300; 

0111 



SEP SUB; ,#0D 

. .CR = CARRIAGE RET 

8047 

030A; 

0112 

ST2: 


SEP SUB; ,#0A 

..LF=LINE FEED 

8049 

032A; 

0113 



SEP SUB; ,#2A 

..★ PROMPT CHARAC 

804B 

F8OOA0B0; 

0114 

IGNORE: 

LDI#00 ;PLO ASL;PHI . 

ASL ..PREPARE TO INPUT 

804F 

9 

0115 




..HEX DIGITS, 

804F 

9 

0116 




..CLEAR ASL 

804F 

F83BA3; 

0117 



LDI A.O(READAH) ;PLO 

SUB 

8052 

D3; 

0118 



SEP SUB 

..INPUT COMMAND 

8053 

FB24; 

0119 



XRI #24 

. .IS IT "$'• ? 

8055 

C28207; 

0120 



LBZ DOLLAR 


8058 

FB05; 

0121 



XRI #05 

..IS IT ’*!" ? 

805A 


0122 




..TEST $ XRI ! 
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805A 

Al; 

0123 


PLO 

SWITCH 


..AND SAVE RESULT 

805B 

CE; 

0124 


LSZ 




805C 

F B1 E ; 

0125 


XRI 

#1E 


..IS IT "?" ? 

805E 

/ 

0126 





..TES $ XRI ! XRI ? 

805E 

3AAB; 

0127 


BNZ 

IGNORE 


..IGNORE ALL UNTIL 

8060 

/ 

0128 





..COMMAND IS READ 

8060 

9 

0129 

4 





8060 

9 

0130 

- . THE 

FOLLOWING IS COMMON 

FOR 

.? M AND ! M 

8Q60 

9 

0131 

,, (SWITCH- 

0 = 0 FOR THE LATTER) 

8060 

9 

0132 

• • 





8060 

D3; 

0133 

R D A R G S : 

SEP 

SUB 


..NOTE SUB AT 

8061 

/ 

0134 





. .READAH. READ 

8061 

9 

0135 





..HEX ARGUMENTS 

8061 

FB4D; 

0136 


XRI 

/y4D 


-.SHOULD BE "M" 

a063 

3ADC; 

0137 


BNZ 

ISITR 


..CK FOR ?R 

8065 

D3; 

0138 

RD1 : 

SEP 

SUB 



8066 

3B65; 

0139 


BNF 

*-#01 


..IGNORE NON HEX 

8068 


0140 





..CHARS. AFTER "M” 

8068 

D3; 

0141 


SEP 

SUB 



8069 

3368; 

0142 


BDF 

*-#01 


. - READ FIRST AR6 

806B 

/ 

0143 





. . (LOCA. IN MEMORY) 

806B 

9DB0; 

0144 


GHI 

ASL ;PHI PTER 



806D 

8DA0; 

0145 


GLO 

ASL ;PLO PTER 


..PTER NOW POINTS 

806F 


0146 





..TO USER MEMORY 

806F 

F800ADBD; 

0147 


LDI#00 ;PL0 ASL ;PHI 

ASL 

..CLEAR ASL 

8073 

ID; 

0148 


INC 

ASL 


..7MXXXXCR PRINTS 

8074 

/ 

0149 





. -TWO HEX DIGITS 

8074 

9FFeOD; 

0150 


GHI 

RF ;XRI#OD 


..CK FOR CR 

8077 

3A7E; 

0151 


BNZ 

TEST 


..BR IF NOT A CR 

8079 

81; 

0152 


GLO 

SWITCH 



807A 

3A8D; 

0153 


BNZ 

LINE-#03 


- .BR IF ? 

807C 

3 0 E1 ; 

0154 


ER SYNERR 


..OTHERWISE ERROR 

807E 

FB2D; 

0155 

TEST: 

XRI#2D 


..CK FOR SPACE 

8080 

3AE1 ; 

0156 


BNZ 

SYNERR 



8082 

2D; 

0157 


DEC 

ASL 


..ADJUST ASL 

8083 

81; 

0158 


GLO 

SWITCH 


..LOOK AT SWITCH 

8084 

32C6; 

0159 


BZ EX1 


..IF 0 IT IS **!" 

8086 

9 

0160 





..OTHERWISE IT'S ? 

8086 

9 

0161 

a a 





8086 

9 

0162 

. • THE 

FOLLOWING DOES (?M LOC COUNT) AND 

8086 

9 

0163 

.. (7MXXXXCR) COMMANDS 



8086 

D3; 

0164 

RD2: 

SEP 

SUB 



8087 

3386; 

0165 


BDF 

RD2 


. .READ SECOND ARG 

8089 

9 

0166 





..(NUMBER OF BYTES) 

8089 

FBOD; 

0167 


XRI 

#0D 


-.NEXT CK FOR CR 

808B 

3AE1 ; 

0168 


BNZ 

SYNERR 



808D 

F89CA3; 

0169 


LDI 

A.0(TYPE5D) ;PLO 

SUB 

-TYPE 

8090 

D30A; 

0170 

LINE: 

SEP 

SUB; ,#0A 


. -LF 

8092 

90BF; 

0171 


GHI 

PTER ;PHI CHAR 


..PREPARE LINE 

8094 

9 

0172 





. -HEADING 

8094 

F8AEA3; 

0173 


LDI 

A.0(TYPE2) ;PLO 

SUB 


8097 

D3; 

0174 


SEP 

SUB 


..TYPE 2 HEX DIGITS 

8098 

80BF; 

0175 


GLO 

PTER ;PHI CHAR 



809A 

F8AEA3; 

0176 


LDI 

A.0(TYPE2) ;PLO 

SUB 


8090 

D3; 

0177 


SEP 

SUB 


..TYPE OTHER TWO 

809E 

D320; 

0178 

TSPACE : 

SEP 

SUB; ,#20 


. -SPACE 

80A0 


0179 

a - 





80A0 

AOBF; 

0180 

TLOOP: 

LDA 

PTER ;PHI CHAR 


- .FETCH ONE BYTE 

80A2 

9 

0181 





..FOR TYPING 

80A2 

F8AEA3; 

0182 


LDI 

A.0(TYPE2) ;PLO 

SUB 


80A5 

D3; 

0183 


SEP 

SUB 


..TYPE 2 HEX 

60A6 

2D; 

0184 


DEC 

CNTER 
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80A7 

8D; 

0185 


GLO CNTER 




80A8 

3AAD; 

0186 


BNZ TL3 



..BRANCH NOT DONE 

80AA 

9D; 

0187 


GHI CNTER 




80AB 

323F; 

0188 


BZ START 



..BRANCH IF DONE 

80AD 

80FA0F; 

0189 

TL3: 

GLO PTER ;ANI #0F 


. .PTER DIV BY 16? 

80B0 

3AB8; 

0190 


BNZ TL2 




80B2 

D33B; 

0191 


SEP SUB; ,nZB 



..YES TYPE 

80B4 

D30D; 

0192 


SEP SUB; ,#0D 



..THEN CR 

80B6 

3090; 

0193 


BR LINE 




80B8‘ 

F6; 

0194 

TL2: 

SHR 



..DIV BY 2? 

80B9 

33A0; 

0195 


BDF TLOOP 



. .NO, LOOP BACK 

80BE 

309E; 

0196 


BR TSPACE 



..ELSE TYPE SPACE & 

^OBD 

/ 

0197 





..LOOP BACK 

:^OBD 


0198 

* * 





i80BD 

■ 

0199 

., THE 

FOLLOWING DOES 

( !M 

LOC 

DATA) COMMAND 

80BD 

/ 

0200 

.. ENTER AT EX1 




80BD 

9 

0201 

* « 





80BD 

9 

0202 

EFFECT OF THE FOLLOWING 

IS 

TO READ IN HEX 

80BD 

9 

0203 

TERMINATING WITH A 

CR, 

IGNORING NON-HEX CHAR 

80BD 

9 

0204 

.. PAIRS; EXCEPTIONS: 

A COMMA 

BEFORE A CR ALLOWS 

80BD 

9 

0205 

. . THE 

INPUT TO CONTINUE ON THE NEXT LINE AND A 

80BD 

9 

0206 

SEMICOLON ALLOWS THE !M 

COMMAND TO BE ASSUMED. 

80BD 

9 

0207 

» . 





80BD 

D3; 

0208 

EX3 : 

SEP SUB 



..INPUT UNTIL A 

80BE 

/ 

0209 





..HEX IS READ 

80BE 

3BBD; 

0210 


BNF EX3 




80C0 

D3; 

0211 

EX2: 

SEP SUB 



..LOOK FOR SECOND 

80C1 

9 

0212 

- 




..HEX DIGIT 

80C1 

3BE1 ; 

0213 


BNF SYNERR 



. .BR IF NOT HEX 

80C3 

8D50; 

0214 


GLO ASL ;STR PTER 


. .★★SET BYTE^^ 

80C5 

10; 

0215 


INC PTER 




80C6 

D3; 

0216 

EX1 : 

SEP SUB 



. .NOTE SUB a READAH 

80C7 

33CO; 

0217 


BDF EX2 



..BRANCH IF HEX 

80C9 

FBOD; 

0218 


XRI /yOD 



. .CHECK IF CR 

80CE 

3 23F; 

0219 


BZ START 




80CD 

FB21 ; 

0220 

EX4 : 

XRI #21 



..ELSE CK FOR COMMA 

80CF 

/ 

0221 





. . (TEST CR XRI 

80CF 

3 2BD; 

0222 


BZ EX3 



..IF ELSE BRANCH 

80D1 

FB17; 

0223 


XRI #17 



..ELSE CK FOR " 

80D3 

/ 

0224 





..(TEST CR XRI 

80D3 

/ 

0225 





XRI 

8003 

3AC6; 

0226 


BNZ EX1 



..IGNORE ALL ELSE 

8005 

D3; 

0227 


SEP SUB 



..ON IGNORE ALL 

8006 

9 

0228 





-.UNTIL CR, THEN 

8006 

9 

0229 





..LOOP BACK 

8006 

FBOD; 

0230 


XRI #0D 




8008 

3AD5; 

0231 


BNZ *-03 




800A 

3065; 

0232 


BR RD1 



..THEN BRANCH BACK 

800C 


0233 





..FOR !M COMMAND 

800C 

FBI F; 

0234 

ISITR : 

XRI#1F 



- . IS IT R? 

800E 

C282E8; 

0235 


LBZ TYPER 



. .BR IF R 

80E1 

/ 

0236 






80E1 

F89CA3; 

0237 

SYNERR: 

LDI A.0(TYPE5D) 

;PLO 

SUB 

..GENERAL RESULT 

80E4 

9 

0238 





..SYNTACTIC ERROR 

80E4 

D30D; 

0239 


SEP SUB; ,#0D 



. .CR 

80E6 

C08200; 

0240 


LBR FSYNER 




80E9 

/ 

0241 

• a 





80E9 

/ 

0242 






80E9 

9 

0243 

* • 





80E9 

9 

0244 

•, SUBROUTINES 




80E9 

9 

0245 

a a 





80E9 

9 

0246 

a a 
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80E9 


0247 



0RG*+#01 



80EA 


0248 

m m 

DELAY ROUTINE 



80EA 


0249 

« * 

DELAY IS 2(1+AUX. 

1(3+aSUB)) 

80EA 


0250 

m m 

USED 

BY TYPE, READ, AND TIMALC. 

80EA 


0251 

m m 

AUX. 

1 IS ASSUMED 

TO HOLD A 

DELAY CONSTANT 

80EA 


0252 

• * 

=((BIT TIME OF TERMINAL)/ 


80EA 


0253 

« • 

(20*INSTR TIME OF 

COSMAO) 

-1 . 

80EA 


0254 

■ ■ 

THIS 

CONSTANT CAN 

BE GENERATED 

80EA 


0255 

■ • 

AUTOMATICALLY BY 

THE TIMALC ROUTINE. 

80EA 


0256 






80EA DCDCDCDC; 

0257 

DEXIT: 

SEP RC;SEP RC 

;SEP RC;SEP RC ..4 NOP'S 

80EE D3; 

0258 



SEP SUB 

..RETURN 

80EF 9EF6AE; 

0259 

DELAY1 : 

GHI AUX ;SHR 

;PLO AUX 

..SHIFT OUT 

?i80F2 . 


0260 





..ECHO FLAG 

‘80F2 2E; 

0261 

DELAY2 : 

DEC AUX 


. .AUX.O HOLDS BASIC 

8i)F3 


0262 





..BIT DELAY 

80F3 43FF01; 

0263 



LDA SUB ;SMI 

#01 

..PICK UP CONSTANT 

80F6 3AF4; 

0264 



BNZ *-#02 


..LOOP AS SPECIFIED 

80F8 

i 

f 

0265 





..BY CALL 

80F8 8E; 

0266 



GLO AUX 


..DONE YET? 

80F9 32EA; 

0267 



EZ DEXIT 



80FB 23; 

0268 



DEC SUB 


..POINTS SUB AT 

80FC ; 

0269 





..DELAY POINTER 

80FC 30F2; 

0270 



BR DELAY2 



80FE 


0271 






80FE 


0272 


ROUTINE TO CALCULATE BYTE 

TIME AND ECHO 

80FE 


0273 


FLAG 

WAITS FOR 

LF(NO ECHO) OR CR(ECHO) 

80FE 


0274 


TO BE TYPED IN¬ 

ALSO SETS 

UP POINTER TO 

80FE 


0275 


DELAY ROUTINE- 



80FE 


0276 


AUX. 

1 ENDS UP HOLDING, IN 

THE MOST 

80FE 


0277 


SIGNIFICANT 7 BITS, THE DELAY CONSTANT. 

80FE 


0278 

■ • 

LEAST SIGNIFICANT BIT IS ZERO FOR ECHO, 

80FE 


0279 

• « 

ONE 

FOR NO ECHO- 



80FE 


0280 

■ • 





80FE 93BC; 

0281 

TIMALC: 

GHI SUB ;PHI 

DELAY 


8100 I 

F8EFAC; 

0282 



LDI A.O(DELAYI) ;PLO DELAY 

8103 1 

F800AEAF; 

0283 



LDI #00 ;PLO 

AUX ;PLO 

CHAR 

8107 


0284 





..DELAY ROUT. READY 

8107 3707; 

0285 



B4* 


..WAIT START BIT 

8109 3F09; 

0286 



BN4* 


..WAIT FOR FIRST 

810B 

■ 

f 

0287 





..NONZERO DATA BIT 

81CB 1 

F803; 

0288 



LDI #03 


..SET UP FOR 10 

810D 

• 

0289 





..EXECUTIONS SO 

810D 

9 

0290 





..ROUND-OFF MINIMAL 

810D 

FF01 ; 

0291 

TC2 

1 

SMI #01 



810F : 

3AOO; 

0292 



BNZ *-#02 



8111 i 

BF; 

0293 



GLO CHAR 


..LOOK TO SEE IF 

8112 

/ 

0294 





..DATA CHANGED 

8112 

/ 

0295 





..PREVIOUSLY 

8112 

3A17; 

0296 



BNZ ZRONE 


..BR IF IT 6HAD 

8114 

3719; 

0297 



B4 INCR 


..ELSE LOOK FOR 

8116 

; 

0298 





..CHANGE TO ZERO 

8116 

w 

0299 





..BRANCH IF NO 

8116 

IF; 

0300 



INC CHAR 


..YES, SET SWITCH 

8117 

371E; 

0300 

ZROME: 

B4 DAUX 


..LOOK FOR CHANGE 

8119 

9 

0301 





..TO 1, BR IF YES 

8119 

IE; 

0302 

INCR: 

INC AUX 



811 A 

F807; 

0303 



LDI #07 


..SET UP FOR 20 

811C 

9 

0304 





..INSTRUCTION LOOPS 

811C 

300D; 

0305 



ER TC2 



811E 


0306 

to to 





811E 


0307 

■ ■ 

AUX 

.0 NOW HOLDS i 

tfLOOPS IN 

2 BIT TIMES 

811E 


0308 

to to 
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811E 

2E2E; 

0309 

DAUX: 

DEC 

AUX ;DEC AUX 



..REDUCE COUNT TO 

8120 

9 

0310 






..BALANCE FIXED 

8120 

/ 

0311 






..OVERLOAD IN 

8120 

/ 

0312 






..CALLING DELAY 

8120 

8EF901BE; 

0313 


GLO 

AUX ;ORI #01 ; 

PHI 

AUX..LSB AUX.1 = 1.5 

8124 

DCOC; 

0314 


SEP 

RC; ,#0C 



..BIT TINE DELAY 

£126 

3F2C; 

0315 


eN4 

WAIT 



..BR IF LF(NO ECHO) 

8128 

/ 

0316 






..LSB AUX.1=1 

8128* 

9EFAFE; 

0317 


GHI 

AUX ;ANI#FE 




812e 

BE; 

0318 


PHI 

AUX 



..CR(ECHO) 

812C 

/ 

0319 






..LSB AUX.1=0 

81 2C 

DC26; 

0320 

WAIT: 

SEP 

RC; ^#26 




f12E 

D5; 

0321 


SEP 

R5 




B12F 

/ 

0322 







8t2F 

9 

0323 







812F 

9 

0324 

.. READ ROUTINE--READS 1 

BYTE 

INTO CHAR.1. WHEN 

812F 

9 

0325 

.. ENTERED 

VIA READAH, THEN 

IF 

INPUT IS A HEX 

812F 

9 

0326 

.. DIGIT ITS HEX VALUE IS 

SHIFTED INTO ASL FROM 

812F 

9 

0327 

. • THE 

RIGHT AND DF=1, ELSE 

DF 

=0; CLOBBERS CHAR, 

812F 

9 

0328 

. . AUX 

.0, 

(ASL ON READAH) 

a 

LEAVES BYTE IN D 

812F 

9 

0329 

.. (BUT CLOBBERED IF SUBR 

LINKAGE IS USED). 

812F 

9 

0330 

.. LEAVES 

PC AT READAH ENTRY 

POINT; EXITS TO R5. 

812F 

9 

0331 







812F 

9 

0332 







812F 

9 

0333 

■ m 

WARNING: READ PROCESS 

HAS NOT FINISHED. DO 

812F 

9 

9 

0334 

m m 

NOT 

TYPE IMMEDIATELY, 

OR 

ELSE ENTER TYPE VIA 

812F 

9 

0335 

m^m 

TYPESDa 




812F 

m 

9 

0336 

m m 






812F 

9 

0337 

m m 






812F 

FC07; 

0338 

CKDEC : 

ADI 

#07 



..CK FOR ASCII 

8131 

/ 

0339 






..DECIMAL INPUT 

8131 

3337; 

0340 


6DF 

NFND 




8133 

FCOA; 

0341 


ADI 

#0A 




8135 

3377; 

0342 


BDF 

FND 



..SUB NET 30 

8137 

FCOO; 

0343 

NFND: 

ADI 

#00 



..SETS DF=0 

8139 

9F; 

0344 

REXIT: 

GHI 

CHAR 



..CHARACTER INTO D 

813A 

D5; 

0345 


SEP 

R5 




813B 

F800; 

0346 

READAH: 

LDI 

#00 




8130 

38; 

0347 


SKP 




..SKIP OVER 

813E 

9 

0348 






-.TO READ1 

813E 

93; 

0349 

READ: 

GHI 

SUB 



. .CONSTANT WITH 

813F 

9 

0350 






..A VALUE > 0 

813F 

AF; 

0351 

READ1: 

PLO 

CHAR 



..SET ENTRY FLAG 

8140 

F880BF; 

0352 

READ2: 

LDI 

#80 ;PHI CHAR 



..INITIALIZE INPUT 

8143 

9 

0353 






..BYTE-WHEN SHIFTED 

8143 

9 

0354 






..80 IS 1, WILL BE 

8143 

9 

0355 






. .DONE 

8143 

E2; 

0356 


SEX 

ST 




8144 

3F44; 

0357 


BN4 

* 



..WAIT FOR END OF 

8146 

/ 

0358 






..LAST DATA BIT 

8146 

17 ^ 6 ; 

0359 


B4 

* 



..WAIT FOR PRESENT 

8148 

9 

0360 






..START BIT 

8148 

DC02; 

0361 


SEP 

RC; ,#02 



..DELAY HALF 

814A 

9 

0362 






..BIT TIME 

814A 

9 

0363 

a a 






814A 

F80052; 

0364 

NOBIT: 

LDI 

#00 ;STR ST 




8140 

9EFA01; 

0365 

LOOPS: 

GHI 

AUX ;ANI #01 



..CHECK IF ECHO 

8150 

9 

0366 






..INDICATOR IS 

8150 

9 

0367 






-.LSB OF AUX.1 

8150 

F152; 

0368 


OR 

;STR ST 



..OUTPUT IS ONE(NO 

8152 

9 

0369 






-.EFFECT) ON NOECHO 

8152 

6722; 

0370 


OUT 

7 ;DEC ST 
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8154 , 


0371 

• • 





8154 DC07; 

0372 

L00P5B: 

SEP 

RC; ,#07 

-.DELAY ONE 

8156 , 

■ 

f 

0373 





..BIT TIME 

8156 F80152; 

0374 



LDI 

#01 ;STR ST 


8159 9FF6BF; 

0375 



6HI 

CHAR ;SHR ;PHI CHAR ..SHIFT INPUT CHAR. 

815C 3365; 

0376 



BDF 

NEXT 

..BR IF INPUT 

815E 

■ 

f 

0377 





-.FINISHED D=CHAR.1 

815E F980; 

0378 



ORI 

tfBO 


8160 3F4A; 

0379 



BN4 

NOBIT 

..BR IF INPUT 

8162 , 

• 

f 

0380 





..BIT A ZERO 

8162 BF; 

0381 



PHI 

CHAR 

..ELSE PUT OK'D 

8163 ; 

0382 





--VALUE AWAY 

8^163 304D; 

0383 



BR 

LOOPS 


^‘8165 ; 

0384 

• • 





;^ 8165 ; 

0385 

m m 

NOW 

HAVE BYTE READ INTO 

CHAR.1 

8165 , 

' 

0386 

• • 





8165 6722; 

0387 

NEXT 


OUT 

7; DEC ST 

. .OUTPUT STOP BIT 

8167 3240; 

0388 



BZ 

READ2 

..BR IF D=0, 

8169 

’ 

0389 





..CHAR.1 IS A NULL 

8169 8F; 

0390 



GLO 

CHAR 

..CHECK ENTRY FLAG 

816A 3A39; 

0391 



BNZ 

REXIT 

..BR IF ENTRY VIA 

816C , 

' 

0392 





. .READ 

816C 9F; 

0393 

CKHXE: 

GHI 

CHAR 


816D FF41; 

0394 



SMI 

)V41 

..CK FOR ASCII HEX 

816F 3B2F; 

0395 



BNF 

CKDEC 

..AT TOP OF ROUTINE 

8171 FF06; 

0396 



SMI 

#06 

..CK FOR A THRU F 

8173 3337; 

0397 



BDF 

NFND 


8175 FC10; 

0398 

- 


ADI 

#10 

..SUB NET 37 

8177 , 

r 

0399 

• m 





8177 AE; 

0400 

FND: 


PLO 

AUX 

..SAVE TO SHIFT 

8178 , 

r 

0401 





..INTO ASL 

8178 9D; 

0402 



GHI 

ASL 


8179 FEFEFEFE; 

0403 



SHL 

;SHL ;SHL ;SHL 

..SHIFT ASL.1 

817D ; 

0404 





..LEFT FOUR 

8170 52; 

0405 



STR 

ST 


817E 80; 

0406 



GLO 

ASL 


817F F6F6F6F6; 

0407 



SHR 

;SHR ;SHR ;SHR 

-.SHIFT ASL.O RT 4 

8183 FIBO; 

0408 



OR 

;PHI ASL 

. .COMBINE 

8185 80; 

0409 



GLO 

ASL 


8186 FEFEFEFE; 

0410 



SHL 

;SHL ;SHL ;SHL 

. -SHIFT ASL.O 

818A ; 

0411 





..LEFT FOUR 

818A 52; 

0412 



STR 

ST 


818B 8EFA0FF1A0; 

0413 



GLO 

AUX ;ANI #0F ;0R 

;PLO ASL ..COMBINE 

8190 FFOO; 

0414 



SMI 

#00 

-.SET DF 

8192 3039; 

0415 



BR 

REXIT 


8194 


0416 






8194 


0417 

■ • 

TYPE 

ROUTINE -- TYPES 1 

BYTE FROM SR5!, aR6!, 

8194 


0418 

* m 

OR CHAR 

..1, OR TYPES A BYTE AS 2 HEX DIGITS FROM 

8194 


0419 

m m 

CHAR 

.1 

FOLLOWS A LINE FEED BY SIX NULLS. 

8194 


0420 

« m 

USES 

2 

AUXILIARY REGS - 

AUX AND CHAR - PLUS 

8194 


0421 

* m 

RAM 

LOCATION aST. EXITS 

READY TO TYPE 1 BYTE 

8194 


0422 


FROM 

aR5 ! . EXITS TO R5 

WHEN ENTERED AT TYPE5D, 

8194 


0423 


PAUSES 

TO ALLOW AN EARLIER READ TO COMPLETE- 

8194 


0424 






8194 


0425 

* m 

AUX. 

0 HOLDS OUTPUT CHAR 

(AT FIRST), THEN THE 

8194 


0426 

* • 

DELAY CONSTANT BETWEEN BITS. CHAR.O HOLDS THE 

8194 


0427 

• ■ 

NUMBER 

OF BITS (11) IN ITS LOWER DIGIT, AND 

8194 


0428 


IN ITS 

UPPER DIGIT HOLDS 

A CODE -- 

8194 


0429 

m m 



0 FOR BYTE OUTPUT 

8194 


0430 

m m 



1 FOR FIRST HEX 

OUTPUT 

8194 


0431 




2 FOR LAST NULL 

OUTPUT 

8194 


0432 




8 FOR LF OUTPUT 
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8194 


0433 

8194 


0434 

8194 

/ 

0435 

819C 

DC17; 

0436 

819E 

38; 

0437 

819F 

D5; 

0438 

81 AO 

4538; 

0439 

81A2 

/ 

0440 

81 A2 

4638; 

0441 

81 A4 


0442 

81 A4 

9F; 

0443 

81A5 

AE; 

0444 

81A6 

FBOA; 

0445 

^iA8 

3AC0; 

0446 

8.1 A A 

F88B; 

0447 

81 AC 


0448 

81 AC 

30C2; 

0449 

81 AE 

9F; 

0450 

81AF 

F6F6F6F6; 

0451 

81B3 

? 

0452 

81B3 

FCF6; 

0453 

81B5 

3BB9; 

0454 

81B7 

FC07; 

0455 

81B9 

FFC6AE; 

0456 

81BC 

F81B; 

0457 

81BE 

30C2; 

0458 

81C0 


0459 

81C0 

F8 0B; 

0460 

81C2 

AF; 

0461 

81C3 


0462 

81C3 

E2; 

0463 

81C4 

r 

0464 

81C4 

F80052; 

0465 

81C7 

67; 

0466 

81C8 

22; 

0467 

81C9 

r 

0468 

81C9 

8E; 

0469 

81 CA 

52; 

0470 

81CB 

DC07; 

0471 

81 CD 

2F; 

0472 

81CE 

F0AEFA0152; 

0473 

81 D3 

67; 

0474 

8104 

22; 

0475 

81D5 

8FFA0F; 

0476 

81D8 

32E28E; 

0477 

81 DB 

/ 

0478 

81 DB 

8EF6F980; 

0479 

81 DF 

52; 

0480 

81E0 

30CA; 

0481 

81E2 

/ 

0482 

81E2 

8FFCFB; 

0483 

81E5 

AF; 

0484 

81E6 

3B9F; 

0485 

81E8 

F F1B ; 

0486 

81 EA 


0487 

81EA 

329F; 

0488 

81 EC 

0 

0489 

81EC 

3BF2; 

0490 

81EE 

0 

0491 

81 EE 

0 

0492 

81 EE 

F800; 

0493 

81F0 

0 

0494 



ORG 

#819C 

TYPE5D; 

SEP 

RC; ,#17 


SKP 


TEXIT: 

SEP 

R5 

TYPE5: 

LDA 

R5 ;SKP 

TYPE6: 

LDA 

R6 ;SKP 

TYPE: 

GHI 

CHAR 

TY1 : 

PLO 

AUX 


XRIiHOA 


BNZ 

TY2 


LDI«8B 


BR 

TY3 

TYPE2: 

GHI 

CHAR 

TY4; 

SHR 

;SHR ;SHR 


ADI«/F6 
BNF * + n(n 
ADI#07 

SMI#C6 ;PL0 AUX 
LDI#1B 
BR TY3 

m • 

TY2: LDI#0B 

TY3: PLO CHAR 

SEX ST 

BEGIN: LDI/^00 ;STR ST 

OUT 7 
DEC ST 

GLO AUX 

PREBIT: STR ST 
BITS: SEP RC; ^#07 

DEC CHAR 
LDX ;PLO AUX ;ANI/!^01 
OUT 7 
DEC ST 

GLO CHAR ;ANI#OF 
BZ NXCHAR ;GLO AUX 

GLO AUX ;SHR ;0RI#80 
STR ST 
BR PREBIT 

m • 

NXCHAR: GLO CHAR ;ADI#FB 
PLO CHAR 
BNF TEXIT 
SMI#1B 

BZ TEXIT 

BNF HEX2 


LDI#00 


-.3 BIT TIME DELAY 
..SKIP TO TYPES 

..ENTRY FOR UT20 
..SKIP TO TYPE 
..ENTRY FOR G.P. 

. .IMMED^TH 

..SAVE BYTE 

..IS IT LINE FEED? 

.. in BITS) + (# NULLS 
..TO FOLLOW LF + 1) 

..UT20 ENTRY 
..SHIFT FIRST HEX 
..TO THE RIGHT 
-.CONVERT TO HEX 
-.IF "A" OR MORE 
..ADD NET 37 
. -ELSE ADD NET 30 
..10+(# OF BITS) 


..#BITS TO OUTPUT 
..SAVE MAIN TALLY 
.-VALUE 


..FOR START BIT 

..BACK TO WHERE 
..IT WAS 
..PUT CHAR BACK 

..DELAY 1 BIT TIME 
-.DECREMENT TALLY 
;STR ST 

..OUTPUT DATA BIT 


..AUX.O TO STRETCH 
. .DELAY 
-.SHIFT TO 
-.NEXT BIT 


..SET UP FOR 
..NEXT CHAR 
..EXIT IF NO MORE 
..TEST FOR 
..ALTERNATIVES 
..IF JUST TYPED 
..LAST NULL 
..IF JUST TYPED 
.-FIRST NULL, LF 
..OR NULL 
..PREPARE TO TYPE 
. .NULL 
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81F0 

30FD; 

0495 



BR HX22 



81F2 

• 

0496 

m • 





81F2 

9FFA0F; 

0497 

HEX2 

; 

GHI CHAR ;ANIIII0F 


..GET SECOND HEX 

81 F5 

. 

0498 





..DIGIT 

81F5 

FCF6; 

0499 



ADI#F6 


..CONVERT TO HEX 

81 F7 

3BFB; 

0500 



BNF *+#04 


..IF "A" OR MORE 

81 F9 

FC07; 

0501 



ADI#07 


..ADD NET 37 

81 FB 

FFC6; 

0502 



SKI#C6 


..ELSE ALL NET 30 

81 FD 

AE; 

0503 

HX22 

: 

PLO AUX 


..STORE CHAR AWAY 

81FE 

30CA; 

0504 



BR BEGIN 



8200 

/ 

0505 

« a 





8200 

/ 

0506 

m m 





.8200 

D30A; 

0507 

FSYNER: 

SEP SUB; ,#0A 


..LF 

8202 

033F; 

0508 



SEP SUB; ,#3F 


..? 

8204 

C0803F; 

0509 



LBR START 



8207 

m 

0510 






8207 


0511 

■ m 

THE 

FOLLOWING DOES $P HHHH 

,$U HHHH 

8207 


0512 

% a 





8207 

FS5FA1; 

0513 

DOLLAR: 

LDI A.O(INTRPT) ;PLO 

R1 ..R1 IS POINTING 

820A 

F882B1; 

0514 



LDI A.KINTRPT) ;PHI 

R1 ..AT INTRPT 

820D 

D3; 

0515 



SEP SUB 


..SUB.O=READAH 

820E 

FB55; 

0516 



XRI #55 


..CHECK FOR "U" 

8210 

3231 ; 

0517 



BZ D1 


..CON'T WITH "U" 

8212 

FB19; 

0518 



XRI #19 


..CHECK FOR "L" 

8214 

3245; 

0519 



EZ DOLL 


..IF "L" 

8216 

FBI C; 

0520 



XRI#1C 


..CK FOR "P” 

8218 

CA80E1; 

0521 



LBNZ SYNERR 


..NOT P EITHER 

82ie 

D3; 

0522 

- 


SEP SUE 



821C 

331B; 

0523 



BDF *-#01 


..ASSEMBLE HEX 

821E 

. 

0524 





..STRING INTO ASL 

821E 

FBOD; 

0525 



XRI #0D 


..FIRST NON-HEX 

8220 


0526 





..MUST BE CR 

8220 

CA80E1; 

0527 



LBNZ SYNERR 



8223 

F89CA3; 

0528 



LDI A.0<TYPE5D) ;PLO 

SUB 

8226 

D30A ; 

0529 



SEP SUB; ,#0A 


. .LF 

8228 

E5; 

0530 



SEX PC 



8229 

7055; 

0531 



RET,#55 



822B 

6100; 

0532 



OUT 1,#00 


..CLEAR I/O DECODER 

822D 

6704; 

0533 



OUT 7,#04 


..BIT 2 deselect; 

S22F 


0534 





..THE 2 LEVEL I/O 

822F 

3039; 

0535 



BR D2 



8231 

D3; 

0536 

D1 : 


SEP SUB 



8232 

3331 ; 

0537 



BDF D1 


..ASSEMBLE HEX 

8234 


0538 





..STRING INTO ASL 

8234 

FBOD; 

0539 



XRI #0D 


..FIRST NON-HEX 

8236 

W 

0540 





..MUST BE CR 

8236 

CA80E1; 

0541 



LBNZ SYNERR 



8239 

9DB0; 

0542 

D2; 


GHI ASL ;PHI RO 



823B 

8DA0; 

0543 



GLO ASL ;PLO RO 


..SET UP NEXT PC 

823D 

F89CA3; 

0544 



LDI A.0(TYPE5D) ;PLO 

SUB 

8240 

D30A; 

0545 



SEP SUB; ,#0A 


. .LF 

8242 

E5; 

0546 



SEX PC 



8243 

7000; 

0547 



RET, #00 


..AND USER PROGRAM 

8245 


0548 





..BEGINS (IN RO) 

8245 


0549 





..EXIT TO UT20 

8245 


0550 


THE 

FOLLOWING DOES $L 



8245 

F800A0; 

0551 

D0LL:LDI A.O(LOADER) ;PL0 

RO 

8248 

F884B0; 

0552 



LDI A.KLOADER) ;PHI 

RO 

824B 

EO; 

0553 



SEX RO 



824C 

DO; 

0554 



SEP RO 



824D 


0555 

. a 

MSGE ROUTINE 



824D 


0556 


THIS ROUTINE INITIALIZES 

. RC TO 

824D 


0557 

• - 

POINT AT THE DELAY ROUTINE 

• 
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824D 

/ 

0558 

• • 

IT TYPES OUT DATA POINTED TO 

BY R6. THIS 

82AD 

/ 

0559 

• a 

ROUTINE USES THE STANDARD CALL AND RET ROUTINES. 

824D 

F8EFAC; 

0560 

MSGE:LDI A.O(DELAYI) ;PL0 RC 



8250 

F880BC; 

0561 


LDI A.KDELAYD ;PHI 

RC 


8253 

DC1 2; 

0562 


SEP RC,#12 , 


a a DELAY 

8255 

46BF; 

0563 

STRNGrLDA R6 ;PHI RF 


..LOAD CHAR TO RF.1 

8257 

325E; 

0564 


BZ EXIT1 



8259 

D 4 81 A 4 ; 

0565 


SEP R4; ,A(TYPE) 


a -TYPE OUT CHAR 

825C 

3055; 

0566 


ER STRNG 



825E 

D5; 

0567 

EXIT1 :SEP R5 



82'5F 

/ 

0568 

a a 

INTERRUPT ROUTINE 



825F 

9 

0569 

a a 

IT INITIALIZES R4,R5 TO POINT 

AT 

825F 

9 

0570 

a a 

THE CALL AND RETURN ROUTINES. 

IT CALLS OSTRNG, 

8 25 F 

9 

0571 

a a 

AND OUTPUT 'INTRPT ON' MESSAGE. 

^25F 

9 

0572 

a a 

IT EXITS OSTRNG WITH R3 AS 

PROGRAM COUNTER, 

*825F 

9 

0573 

a a 

THEN IT TRANSFERS CONTROL TO 

UT20- 

825F 

F864A4; 

0574 

IMTRPTrLDI A.O(CALL) ;PLO R4 


.-INITIALIZE CALL 

8262 

9 

0575 




. .POINTER 

8262 

F874A5; 

0576 


LDI A.O(RET) ;PLO R5 


..INITIALIZE RET 

8265 

9 

0577 




a -POINTER 

8265 

F883B4; 

0578 


LDI A.KCALL) ;PHI R4 


..CALL AND RET ON 

8268 

B5; 

0579 


PHI R5 


..SAME PAGE 

8269 

F81FA2; 

0580 


LDI<^1F ;PLO R2 


..INITIALIZE I/O 

826C 

F88CB2; 

0581 


LDI A.KWRAM) ;PHI R2 


a -POINTER 

826 F 

F876A3; 

0582 


LDI A.O(MSG) ;PLO R3 


..INITIALIZE PC 

8272 

F882B3; 

0583 


LDI A.KMSG) ;PHI R3 



8275 

D3; 

0584 


SEP R3 



8276 

D4824D; 

0585 

r?SG 

:SEP R4; ,A(MSGE) 



8279 

494E5452505421 

;0586 


,T'INTRPT!',#00 



8280 

00; 

0586 





8281 

9 

0587 

m 9 

ENTER ROUTINE 



8281 

9 

0588 

m m 

THIS ROUTINE INITIALIZES RC 

TO POINT AT 

8281 

9 

0589 

m m 

THE DELAY ROUTINE. IT ALSO 

INITIALIZES R2 TO 

8281 

9 

0590 

* m 

LOO #8000 (THE I/O LOCATION 

USED BY UT20). 

8281 

9 

0591 

w m 

IT DISABLES INTERRUPT, SELECTS RCA I/O 

8281 

9 

0592 

* , 

GROUP, AND TRANSFERS CONTROL 

TO UT20. 

8281 

E3; 

0593 

ENTER:SEX R3 


. .X = P = 3 

8282 

F8EFAC; 

0594 


LDI A.O(DELAYI) ;PLO 

RC 

-.INITIALIZE RC 

8285 

/ 

0595 




..TO POINT AT THE 

8285 

9 

0596 




..DELAY ROUTINE 

8285 

F880BC; 

0597 


LDI A.KDELAYD ;PHI 

RC 


8288 

F83FA5; 

0598 


LDI A.OCSTART) ;PLO R5 

..INITIALIZE PC 

828B 

F880B5; 

0599 


LDI A.KSTART) ;PHI R5 


828E 

F800AE; 

0600 


LDI#00 ;PLO R2 


..R2 POINTS TO 

8291 

F88CB2; 

0601 


LDI A.KWRAM) ;PHI R2 


. .M(8C00) 

8294 

6101; 

0602 


OUT 1,#01 


..SELECT RCA I/O 

8296 


0603 




. .GROUP 

8296 

7155; 

0604 


DIS,#55 


..DISABLE INTRPT 

8298 

9 

0605 




.-P=X=5 

8298 

9 

0606 

• • 

DSKGO ROUTINE 



8298 

9 

0607 


THIS ROUTINE INITIALIZES R4 

,R5,RC TO 

8298 

9 

0608 

m * 

POINT AT THE CALL, RET, AND 

DELAY 

8298 

9 

0609 

m m 

ROUTINES RESPECTIVELY. 



8298 

9 

0610 

4 m 

THIS ROUTINE DYNAMICALLY DETERMINES THE 

8298 

9 

0611 

m 9 

STACK LOCATIONaAND INITIALIZE 

R2 TO 

8298 

9 

0612 

m • 

POINT AT THAT LOCATION. 



8298 

9 

0613 

« m 

IT ALSO HOMES BOTH DSK DRIVES 

IF POSSIBLE- 

8298 

F805A3; 

0614 

DSKG01:LDI#05 ;PLO R3 



829E 

F800B3; 

0615 


LDI#00 ;PHI R3 



829E 

9 

0616 

DSKG02:0RG * 



829E 

F864A4; 

0617 


LDI A.O(CALL) ;PLO R4 


. -INITIALIZE R4 TO 

82A1 

/ 

0618 




..POINT AT THE 

82A1 

9 

0619 




..CALL ROUTINE 
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82A1 

F874A5; 

0620 

LDI A.O(RET) 

;PLO 

R5 -.INITIALIZE R5 TO 

82A4 

r 

0621 



..POINT AT RET ROU- 

82A4 


0622 



. .TINE 

82A4 

F883BA; 

0623 

LDI A.I(CALL) 

;PHI 

R4 .-R4^R5 ON 

82A7 

B5; 

0624 

PHI R5 


..SAME PAGE 

82A8 

F880B2; 

0625 

LD1#80 ;PHI 

R2 


82AB 

F8FFA2; 

0626 

LDI#FF ;PL0 

R2 


82AE 

92FF01P2; 

0627 

STACK:GHI R2 ;Sri#01 

;PHI R2 ..ASSUME 4K BANKS 

82B2 


0628 



..OF MEMORY 

82B-2 

F85A5202; 

0629 

LDI#5A ;STR 

R2 ; 

LDN R2 ..CK IF RAM EXIST 

82B6 

FB5A3AAE; 

0630 

XRI#5A ;PNZ 

STACK 

--BR IF NO RAM 

82BA 

650B; 

0631 

HOMDSKrOUT 5,//OB 


-.CLEAR ERROR FLAGS 

82BC 

6401 ; 

0632 

OUT 4,//01 


.-OUTPUT UNIT#00 

‘82BE 

6 5 21 ; 

0633 

OUT 5,#21 


..LOAD U/S# 

82C0 

E26E; 

0634 

SEX R2 ;INP 

6 

..READ STATUS 

82C2 

FA20; 

0635 

ANI//20 


..CK DRIVE 

82C4 

EO; 

0636 

SEX RO 



82C5 

3ACF; 

0637 

BNZ UNIT2 


-.PR IF DRIVE FAIL 

82C7 

650D; 

0638 

OUT 5,#0D 


..SEEK TRACK#00 

82C9 

E26E; 

0639 

UNIT1:SEX R2 ;INP 6 

1 

-.READ STATUS 

82CB 

F6; 

0640 

SHR 


-.CK FOR BUSY 

82CC 

33C9; 

0641 

BDF UMIT1 


- -BR IF BUSY 

82CE 

EO; 

0642 

SEX RO 



82CF 

650B; 

0643 

UNIT2:0UT 5,#0B 


..CLEAR ERROR FLAGS 

82D1 

6441 ; 

0644 

OUT 4,//41 


..OUTPUT UNIT^I 

82D3 

6521 ; 

0645 

OUT 5,//21 


..LOAD U/S# 

82D5 

E26E; 

0646 

SEX R2 ;INP 

6 

..READ STATUS 

82D7 

FA20; 

0647 

AMI//20 


--CK DRIVE 

82D9 

EO; 

0648 

SEX RO 



82DA 

3AE4; 

0649 

BNZ EXIT2 


..BR IF DRIVE FAIL 

82DC 

650D; 

0650 

OUT 5,//0D 


- -SEEK TRACK/;/00 

82DE 

E26E; 

0651 

UNITrSEX R2 ;INP 6 


..READ STATUS 

82E0 

F6; 

0652 

SHR 


--CK FOR BUSY 

82E1 

33DE; 

0653 

BDF UNIT 


--BR IF BUSY 

82E3 

EO; 

0654 

SEX RO 



82E4 

6101; 

0655 

EXIT2:0UT 1,#01 


..SELECT RCA I/O 

82E6 


0656 



- -GROUP 

82E6 

E2; 

0657 

SEX R2 



82E7 

D3; 

0658 

SEP R3 



82E8 

/ 

0659 

.. THE FOLLOWING ROUTINE DOES (?R) COMMAND 

82E8 

/ 

0660 

* ■ 



82E8 

/ 

0661 

* H 



82E8 

/ 

0662 

• m 



82E8 

81; 

0663 

TYPER: GLO SWITCH 


..CK IF ? 

82E9 

C280E1; 

0664 

LBZ SYNERR 


..BR IF NOT ? 

82EC 

F89CA3; 

0665 

LDI A.0(TYPE5D) ;PLO 

SUB ..SUB IS POINTING 

82EF 


0666 



..TO TYPE5D ROUTINE 

82EF 

D30D; 

0667 

SEP SUE,#OD 


..TYPE CR 

82F1 

D30A; 

0668 

SEP SUB,#OA 


..TYPE LF 

82F3 

F802AD; 

0669 

LDI//02 ;PLO 

CNTER 

..TYPE R0,R1 

82F6 

D358; 

0670 

TYPEX: SEP SUB^T'X' 


..TYPE X 

82F8 

D358; 

0671 

SEP SUB,T'X' 


..SINCE R0,R1 ARE 

82FA 

D358; 

0672 

SEP SUB,T'X' 


..CLOBBERED BY UT20 

82FC 

D358; 

0673 

SEP SUB,T'X' 


..X=DON'T CARE 

82FE 

D320; 

0674 

SEP SUB,#20 


..TYPE SPACE 

8300 

20; 

0675 

DEC CNTER 



8301 

8 0; 

0676 

GLO CNTER 



8302 

CA82F6; 

0677 

LBNZ TYPEX 


..BR TO TYPE R1 

8305 

F804A0; 

0678 

LDI#04 ;PLO 

PTER 

..TYPE R2,R3 

8308 

F88CB0; 

0679 

LDI#8C ;PHI 

PTER 

..LOAD ADDERSS 

830E 

F802AO; 

0680 

LDI#02 ;PLO 

CNTER 

..LOAD CNTER 

830E 

40BF; 

0681 

TYPER2: LDA PTER ;PHI 

CHAR 

..PRINT 2 HEX DIGIT 

8310 

F8AEA3; 

0682 

LDI A.0(TYPE2) 

;PLO 

SUB 
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8313 

D3; 

0683 

SEP SUB 


8314 

40BF; 

0684 

LDA PTER ;PHI CHAR 


8316 

F8AEA3; 

0685 

LDI A.0(TYPE2) ;PL0 SUB 


8319 

D3; 

0686 

SEP SUB 


831 A 

F89CA3; 

0687 

LDI A.OCTYPESD) ;PLO SUB 

831 D 

80FB08; 

0688 

GLO PTER ;XRI#08 


8320 

C6; 

0689 

LSNZ 


8321 

D3 2C; 

0690 

SEP SUB^T',* 


8323 

D320; 

0691 

SEP SUB,#20 


8325 

.2D; 

0692 

DEC CNTER 


8326 

8D3AOE; 

0693 

GLO CNTER ;ENZ TYPER2 


8329 

D358; 

0694 

SEP SUB,T'X' 


832B 

D358; 

0695 

SEP SUB,T'X' 


SSZD 

F809A0; 

0696 

LDI#09 ;PLO PTER 


8^30 

F88CB0; 

0697 

LDI#8C ;PHI PTER 


8333 

F816AD; 

0698 

LDI#16 ;PLO CNTER 


8336 

40BF; 

0699 

LDA PTER ;PHI CHAR 


8338 

F8AEA3; 

0700 

LDI A.0(TYPE2) ;PLO SUB 


833B 

D3; 

0701 

SEP SUB 

..TYPE OTHER TWO 

833C 

D320; 

0702 

TSPCE: SEP SUB; ,#20 

. .SPACE 

833E 


0703 

a a 


833E 

40BF; 

0704 

TLOOPX: LDA PTER ;PHI CHAR 

. .FETCH ONE BYTE 

8340 


0705 


- .FOR TYPING 

8340 

F8AEA3; 

0706 

LDI A.0(TYPE2) ;PLO SUB 


8343 

D3; 

0707 

SEP SUB 

..TYPE 2 HEX 

8344 

2D; 

0708 

DEC CNTER 


8345 

8D; 

0709 

GLO CNTER 


8346 

3A4C; 

0710 

BNZ TL3A 

- .BRANCH NOT DONE 

8348 

9D; 

0711 

GHI CNTER 


8349 

C2803F; 

0712 

LBZ START 

-.BRANCH IF DONE 

834C 

80FB18; 

0713 

TL3A: GLO PTER ;XRI#18 

..CK IF RC? 

834F 

3A53; 

0714 

BNZ TLX 


8351 

D32C; 

0715 

SEP SUB,T', ' 


8353 

80FA0F; 

0716 

TLX: GLO PTER ;ANI #0F 

--PTER DIV BY 16? 

8356 

3A5E; 

0717 

BNZ TL2A 


8358 

D30D; 

0718 

SEP SUB; ,#0D 

..THEN CR 

835A 

D30A; 

0719 

SEP SUB,#OA 

..TYPE LF 

835C 

303E; 

0720 

BR TLOOPX 


835E 

F6; 

0721 

TL2A: SHR 

. -DIV BY 2? 

835F 

333E; 

0722 

BDF TLOOPX 

. .NO,. LOOP BACK 

8361 

303C; 

0723 

BR TSPCE 

- - ELSE TYPE SPACE & 

8363 

r 

0724 


..LOOP BACK 

8363 

/ 

0725 

•- STANDARD CALL ROUTINE 


8363 

D3; 

0726 

EXITArSEP R3 

-.R3 IS POINTING 

8364 

/ 

0727 


--TG FIRST INSTR. 

8364 

9 

0728 


..IN SUBROUTINE 

8364 

E2; 

0729 

CALL:SEX R2 

..POINT TO STACK 

8365 

96; 

0730 

GHI R6 

..PUSH R6 ONTO 

8366 

73; 

0731 

STXD 

. .STACK TO PREPARE 

8367 

9 

0732 


..IT FOR P0NTIN6 

8367 

86; 

0733 

GLO R6 

-.TO ARGUMENTS, 

8368 

/ 

0734 


..AND DECREMENT 

8368 

73; 

0735 

STXD 

..TO FREE LOCATION 

8369 

93; 

0736 

GHI R3 

--COPY R3 INTO R6 

836A 

B6; 

0737 

PHI R6 

..TO SAVE RETURN 

836B 

9 

0738 


. .ADDRESS 

836B 

00 

0739 

GLO R3 

..SAVE THE RETURN 

836C 

9 

0740 


. .ADDRESS 

836C 

A6; 

0741 

PLO R6 

..SAVE THE RETURN 

836D 

/ 

0742 


. .ADDRESS 

836D 

46; 

0743 

LDA R6 

..LOAD THE ADDRESS 

836E 

9 

0744 


..OF SUBROUTINE 

836E 

B3; 

0745 

PHI R3 

..INTO R3 
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836F 

8370 

8371 
8373 
8373 

8373 

8374 

8374 

8375 

8376 

8376 

8377 
...8378 

8379 
f: 837A 
' .837A 
837B 
837E 
837C 
8370 
837E 
837F 
8382 
8382 
8382 
83F0 
83F3 
83F6 
83F9 
83FC 
83FF 
83FF 
0000 


!M 

0000 

0000 

0000 

0000 

0000 

0000 

8400 

8400 

8400 

8400 

8400 

8400 

8400 

8400 

8400 

8400 

.0 
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46; 

0746 

LDA R6 

..INTO R3 

A3; 

0747 

PLO R3 

..INTO R3 

3063; 

0748 

BR EXITA 

..BRANCH TO ENTRY 

/ 

0749 


. .POINT 

/ 

0750 

.. STANDARD RETURN ROUTINE 


D3; 

0751 

EXITR:SEP R3 

..RETURN TO MAIN 

• 

0752 


. -PROGRAM 

96; 

0753 

RETiGHI R6 

..COPY R6 INTO R3 

B3; 

0754 

PHI R3 

..R3 CONTAINS THE 


0755 


..RETURN 

86; 

0756 

GLO R6 

. -ADDRESS 

A3; 

0757 

PLO R3 

..ADDRESS 

E2; 

0758 

SEX R2 

..POINT TO STACK 

12; 

0759 

INC R2 

..POINT TO SAVED 


0760 


..OLD R6 

72; 

0761 

LDXA 

..RESTORE THE 


0762 


. .CONTENTS 

A6; 

0763 

PLO R6 

..OF R6 

FO; 

0764 

LDX 

..OF R6 

B6; 

0765 

PHI R6 

..OF R6 

9F; 

0766 

GHI RF 


C08373; 

0767 

LBR EXITR 

-.BRANCH TO ENTRY 


0768 


.-POINT 


0769 

.. UT20 VECTOR TABLE 



0770 

0RG#83F0 


C0824D; 

0771 

OSTRNGiLBR MSGE 


C08298; 

0772 

INIT1;LBR DSKG01 


C0829E; 

0773- 

INIT2:LBR DSKG02 


C08281; 

0774 

GOUT20:LBR ENTER 


C0816C; 

0775 

CKHEX: LBR CKHXE 


/■ 

0776 

m m 


/ 

0777 

END 



0001 


0002 


0003 


0004 


0005 


0006 

ORG #8400 

0007 

..THIS ROUTINE IS USED TO LOAD A PROGRAM 

0008 

..WRITTEN IN UT2 FORMAT FROM ICOM FDSK 

0009 

..INTO MEMORY. THIS PROGRAM STARTS ASKING 

0010 

..FOR THE TRACK# AND UNIT#.THESE 

0011 

..NUMBERS SHOULD BE ENTERED FROM 

0012 

..TERMINAL AS HEX DIGITS,THEN THE PROGRAM 

0013 

..SEEKS THE U/TR AND LOAD THE PGM 

0014 

IRX=#60 

0015 

TYPE2=#81AE 

0016 

PTER=#OC ..DCB(DATA CONTROL BLOCK 
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8400 

/ 

0017 


ST=#02 ..STACK POINTER 


8400 

r 

0018 


PC=#03 ..MAIN PROGRAM COUNTER 


8400 

9 

0019 


ASL=(t(OD 


8400 

} 

0020 


AUX=#OE 


8400 

} 

0021 


..I/O PARAMETERS 


8400 

r 

0022 


REA0AH = /i(813B 


8400 

/ 

0023 


TYPE=#81A4 


8400 

/ 

0024 


0STRNG=#83F0 


8400 

r 

0025 


DSKG0=#83F6 


84-00 

r 

0026 


G0UT20=#83F9 


8400 

/ 

0027 


CKHEX=#83FC 


8400 

F809A3; 

0028 


LDI A.0(START-#06) ;PL0 R3 


8403 

F884P3; 

0029 


LDI A.I(START) ;PHI R3 


8406 

C083F6; 

0030 


LBR DSKGO 


8409 

F81FA2; 

0031 


LDI/i(1F ;PLO R2 


840C 

F88Ce2; 

0032 


LDI#8C ;PHI R2 


^840F 

F80OA0E0; 

0033 

START: 

LDI^^OO ;PLO ASL ;PHI ASL ..CLEAR 

ASL 

8413 

EA73; 

0034 


PHI RA ;STXD ..CLEAR 

RA 

8415 

D483F0000A5245 

;0035 

ASK : 

SEP R4 ,A (OSTRNG),#OD,#OA,T'READ?',#00 


841 C 

41443F00; 

0035 




8420 

04813B; 

0036 

ASK1 : 

SEP R4; ,A(READAH) ..READ A CHAR 


8423 

FEOO; 

0037 


XRI#OD ..CK FOR A CR 


8425 

3A20; 

0038 


BNZ ASK1 


8427 

0483F00A4C4F41 

;0039 


SEP R4,A(0STRNG),#0A,T'LOADING',#00 


842E 

44494E4700; 

0039 




8433 

E3; 

0040 


SEX R3 


8434 

6400; 

0041 


OUT 4,#00 ..OUTPUT U/S#00 


8436 

90; 

0042 


GHI ASL 


8437 

3230; 

0043 ' 


BZ CONTIN ..BRANCH IF U/S#00 


8439 

F840; 

0044 


LDI#40 ..UNIT#1 


843B 

6440; 

0045 


OUT 4,#40 ..OUTPUT U/S#40 


8430 

52; 

0046 

CONTIN: 

STR ST ..STORE U/S# IN DCB 


843E 

226521; 

0047 


DEC ST ;OUT 5,#21 ..LOAD THE U/S# 


8441 

650B; 

0048 


OUT 5,#0B ..CLEAR ERROR FLAG 


8443 

6500; 

0049 


OUT 5,#0D ..SEEK TRACK#00 


8 445 


0050 


..THE FOLLOWING ROUTINE CONVERTS A DECIMAL# I 

.N R9. 





8445 


0051 


--HEX AND STORE IT 3DCB PTER 


8445 

E28D; 

0052 

CVY : 

SEX R2;GL0 ASL 


8447 

FF10; 

0053 


SMI#10 


8449 

3B52; 

0054 


BNF RESULT 


844B 

AD; 

0055 


PLO ASL 


844C 

9A; 

0056 


GHI RA 


8440 

FCOA; 

0057 


ADI#OA 


844F 

BA; 

0058 


PHI RA 


8450 

3045; 

0059 


PR CVY --BRANCH IF NOT NEGATIVE 


8452 

8D; 

0060 

RESULT 

:GLO ASL 


8453 

52; 

0061 


STR ST 


8454 

9A; 

0062 


GHI RA 


8455 

F4; 

0063 


ADD 


8456 

73; 

0064 


STXD 


8457 

82AC; 

0065 


GLO ST ;PLO PTER 


8459 

92EC1C; 

0066 


GHI ST ;PHI PTER ;INC PTER 


845C 

1 Cl C; 

0067 


INC PTER ;INC PTER --PTER aTHE BYTE 

COUN 

845E 

D48506; 

0068 


SEP R4,A(EWAIT) ..WAIT UNTIL DISK NOT BUSY 

8461 

D48573; 

0069 

READX : 

SEP R4; ,A(READ) ..READ 1 ASCII DIGIT 


8464 

9 

0070 


..FROM READ BUFFER->RF 

-1 

8464 

CB83F9; 

0071 


LBNF GOUT20 ..READ ERROR RESTART 


8467 

FB21 ; 

0072 


XRI#21 ..CK FOR ! 


8469 

327A; 

0073 


BZ ISITM 


846P 

FB05; 

0074 


XRI #05 ..CHECK FOR $ 


8460 

32C6; 

0075 


BZ ISITU 
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846F 

FB37; 

0076 


XRI #37 ..CHECK FOR E0F(DC3) 

8471 

3A61; 

0077 


BNZ READX 

8473 

D483F000; 

0078 

DONE : 

SEP R4 ,A(0STRNG) ,#00 ..TYPE NULL MESSAGE 

. RESET DELAY PTR 




8477 

n 

C083F9; 

0079 


LBR G0UT20 ..TRANSFER CONTROL TO UT2 

. U 

847A 

D48573; 

0080 

ISITN: 

SEP R4; ,A(READ) 

847D 

CB83F9; 

0081 


LBNF G0UT20 ..READ ERROR RESTART 

8480 

FB4D; 

0082 


XRI#4D ..CK FOR M 

8482 ‘3AE1 ; 

0083 


BNZ ERRORX ..IF NOT M->ERROR 

8484 

D484F6; 

0084 

READX1 

:SEP R4; ,A(READHX) ..READ 1 ASCII DIGIT 

8487 

/ 

0085 


..AND CK IF HEX 

8487 

3399; 

0086 


BDF READX2 ..BR IF HEX 

^489 

FB2E; 

0087 


XRI#2E ..CK IF 

84 8 B 

3A84; 

0088 


BNZ READX1 

8 48D 

D48573; 

0089 

READXA 

:SEP R4; ,A(READ) 

8490 

CB83F9; 

0090 


LBNF 60UT20 ..READ ERROR RESTART 

8493 

FBOD; 

0091 


XRI#OD 

8495 

3A8D; 

0092 


BNZ READXA 

8497 

3084; 

0093 


PR READX1 

8499 

D484F6; 

0094 

READX2 

:SEP R4; ,A(READHX) ..READ 2ND ASCII DIGIT 

849C 

; 

0095 


..AND CK IF HEX 

849C 

3399; 

0096 


BDF READX2 ..BR IF HEX 

849E 

FB20; 

0097 


XRI#20 ..CK IF SPACE 

84A0 

3AE1 ; 

0098 


BNZ ERRORX ..BR IF NOT SPACE 

84A2 

8DA8; 

0099 


GLO ASL ;PLO R8 ..ADDRESS->R8 

84A4 

9DB8; 

0100 


GHI ASL ;PHI R8 

84A6 

D484F6; 

0101 

'READX3 

:SEP R4; ,A(READHX) ..READ AN ASCII DIGIT 

84A9 

; 

0102 


..AND CK FOR HEX 

84A9 

3BBC; 

0103 


BNF READX4 ..BR IF NOT HEX 

34AB 

D484F6; 

0104 

READXE 

:SEP R4; ,A(READHX) ..READ THE 2ND ASCII D 

. 1 

84AE 

/ 

0105 


..AND CK IF HEX 

84AE 

3EE1; 

0106 


BNF ERRORX ..BR IF NOT HEX->ERROR 

84E0 

8D58; 

0107 


GLO ASL ;STR P8 ..STORE AT THE SPECIFIED 

84B2 

• 

/ 

0108 


..ADDRESS 

84E2 

E8F3; 

0109 


SEX R8; XOR ..DID IT WRITE CORRECTLY? 

84E4 

32B9; 

0110 


BZ WRTOK ..YES 

84B6 

D48779; 

0111 


SEP R4,A(N0TRAM) ..NO 

84E9 

18; 

0112 

WRTOK : 

INC R8 

84EA 

30A6; 

0113 


BR READX3 

84EC 

FBOD; 

0114 

READX4 

:XRI#OD ..CK IF CR 

84DE 

3261 ; 

0115 


EZ READX ..IF CP->D0NE 

84C0 

FB36; 

0116 


XRI#36 ..CK FOR SEMICOLON 

84C2 

/ 

0117 


..TEST WITH(CR.XOR.,.XOR. 

84C2 

328D; 

0118 


BZ READXA ..BR IFSEMICOLON 

84C4 

30A6; 

0119 


BR READX3 

84C6 

D48573; 

0120 

ISITU : 

SEP R4 ,A(READ) 

84C9 

CB83F9; 

0121 


LBNF G0LIT20 ..READ ERROR RESTART 

84CC 

FE55; 

0122 


XRI T' U"' 

84CE 

3AE1 ; 

0123 


BNZ ERRORX 

84D0 

D484F6; 

0124 

ADLP : 

SEP R4 ,A(READHX) 

84D3 

33D0; 

0125 


EOF ADLP 

84D5 

8DA0; 

0126 


GLO ASL ;PLO RO 

84D7 

9DB0; 

0127 


GHI ASL ;PHI RO 

84D9 

D483F00D0A00; 

0128 


SEP R4; ,A(0STRNG),#000A,#00 ..OUTPUT A 

. LF 





84DF 

EO; 

0129 


SEX RO 

84E0 

DO; 

0130 


SEP RO 

84E1 

D483F00D0A464F 

;0131 

ERRORX : 

SEP R4; ,A(OSTRNG),#ODOA,T'FORMAT ERROR',#00 


84E8 524D4154204552;0131 
84EF 524F5200; 0131 
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84F3 

C083F9; 

0132 

84F6 

r 

0133 

84F6 

} 

0134 

84 F6 

D48573; 

0135 

84F9 

CB83F9; 

0136 

84FC 

D483FC; 

0137 

84FF 

D5; 

0138 

8500 

/ 

0139 

8500 

/ 

0140 

8500 

} 

0141 

8500 


0142 

8500 

30C6; 

0143 

8502 

3073; 

0144 

8504 

3017; 

0145 

8506 

3011; 

0146 

8508 

C08629; 

0147 

850E 

C0860E; 

0148 

850E 

C087A0; 

0149 

8511 

/ 

0150 

8511 

/ 

0151 

8511 

/ 

0152 

8511 

E2; 

0153 

8512 

6E; 

0154 

8513 

F6; 

0155 

8514 

3311 ; 

0156 

8516 

D5; 

0157 

8517 

/ 

0158 

8517 

/ 

0159 

8517 

r 

0160 

8517 

F810AF; 

0161 

851 A 

4C52; 

0162 

-STACK 


851C 

/ 

0163 

851 C 

6422; 

0164 

851E 

E36511E2; 

0165 

8522 

4C52; 

0166 

.RE ON STACK 


8524 

/ 

0167 

8524 

6422; 

0168 

8526 

E36521; 

0169 

8529 

C4C4C4C4; 

0170 

852D 

6509; 

0171 

852F 

D4860E; 

0172 

8532 

9FFE; 

0173 

8534 

336E; 

0174 

8536 

6EFA08; 

0175 

8539 

3241 ; 

0176 

853B 

9FF940BF; 

0177 

853 F 

306E; 

0178 

8541 

E3650B; 

0179 

8544 

9F; 

0180 

8545 

F6; 

0181 

8546 

334C; 

0182 

8548 

6503; 

0183 

854A 

3054; 

0184 

854C 

6505; 

0185 

854E 

c 

D4860E; 

0186 

■ c 

8551 

E36507; 

0187 

8554 

D4860E; 

0188 

8557 

6E; 

0189 

8558 

FA08; 

0190 


LBR G0UT20 
. . SUBROUTINES 

..THIS ROUTINE READS 1 ASCII DIGIT FROM DISK 

READHX: SEP R4; ,,A(READ) 

LBNF G0UT20 
SEP R4; ,A(CKHEX) 

EXIT: SEP R5 

ORG #8500 


..READ 1 ASCII DIGIT 
.READ ERROR RESTART 
..CK IF HEX 


POINTS 


EWRITE: BR WRITE ..ENTRY TO DISK WRITE ROUTINE 

EREAD: BR READ ..ENTRY TO DISK READ ROUTINE 
ETRNFR: BR TRNFR1 

EWAIT: BR WAIT1 ..ENTRY TO SIMPLE WAIT ROUTINE 
DER: LBR DERROR 
EWAITD: LBR WAIT 

LINEPR: LBR PRNTRF ..LINE PRINTER UTILITY 


•SUBROUTINE WAIT1 


WAIT1: SEX R2 

INP 6 ..GET DISK STATUS 

SHR ..BUSY=>DF 

BDF WAIT1 

SEP R5 ..RETURN 


.SUBROUTINE TRNFR1 


TRNFR1: LDI #10; PLO RF 
LDA PTER; STR R2 


..16 ERRORS ALLOWED 

..GET TRK #,STORE ON 


..POINT TO UNIT-SECT # 

OUT 4; DEC R2 ..OUTPUT THE TRACK # 

SEX R3; OUT 5 ,#11; SEX R2 ..LOAD TRK # 

LDA PTER; STR R2 ..GET UNIT-SECT #,STO 

..POINT TO BYTE COUNT 
OUT 4; DEC R2 ..OUTPUT UNIT-SECT # 

SEX R3;0UT 5 ,#21 ..LOAD UNIT-SECT # 

NOP; NOP; NOP; NOP ..WAIT 48US FOR DISK 

OUT 5 ,#09 ..SEEK TRACK 

SEP R4,A(WAIT) ..WAIT TO SEEK 

GHI RF;SHL ..ERROR FLAG=>DF 

BDF TRNEXT ..DRIVE FAIL ERROR, RETURN 

INP 6; ANI #08 ..CHECK FOR CRC ERROR 

BZ RDWTCK ..NO CRC ERROR 

GHI RF;ORI #40;PHI RF ..SET SEEK ERROR FLAG 

BR TRKNG ..PRINT SEEK ERROR 

SEX R3; OUT 5 ,#0B ..CLEAR ERROR FLAGS 

GHI RF ..CK READ/WRITE FLAG 

SHR ..FLAG INTO DF 

BDF WRTCK ..BR IF WRITE 

OUT 5 ,#03 ..READ 

BR STATUS ..WAIT FOR READ 

OUT 5, #05 ..WRITE 

SEP R4,A(WAIT) ..WAIT TO DO THE WRIT 

SEX R3; OUT 5 ,#07 ..READ CRC 

SEP R4,A(WAIT) ..WAIT FOR COMMAND TO EXECUTE 


INP 6 
ANI #08 


. .BIT3 = 1=>CRC ERROR 


i 
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855A 326E; 

0191 

855C 2F; 

0192 

855D 8F; 

0193 

855E 3A41; 

0194 

8560 D48629; 

0195 

8563 9FFA01F920BF; 

0196 

. G 

8569'306E; 

0197 

,856P 048629; 

0198 TRKNG: 

856E 9FFBFFFE; 

0199 TRNEXT: 

.G=>DF 


8 5,72 D5; 

0200 

8^73 ; 

0201 -- 

8 573 ; 

0202 . 

8573 ; 

0203 -- 

8573 EC; 

0204 READ: 

8574 F800BF; 

0205 

8577 FO; 

0206 

8578 3AB0; 

0207 

857A F800EF; 

0208 REREAD: 

857D F88073; 

0209 

.EXT SECTOR 


8580 ; 

0210 

8580 F0FC0173; 

0211 

.T TRK # 


8584 FA1F; 

0212 

8586 FD1A; 

0213 

8588 3395; 

0214 

858A 1C; 

0215 

858B F0FAC0FC0173; 

0216 

.0 1, POINT TRK # 


8591 F0FC015C; 

0217 

8595 FO; 

0218 CNTOK: 

8596 FD4C; 

0219 

8598 33A1; 

0220 

859A 1 ClC; 

0221 

859C E36500; 

0222 SEX R3;' 

859F 306B; 

0223 

85A1 E2; 

0224 TRKOK: 

85A2 D48517; 

0225 

.FROM DISK TO BUFFER 

85A5 3EBC; 

0226 

85A7 EC; 

0227 

85A8 9FFA203A7A; 

0228 

-ECTOR ON CRC ERR 


85AD F8A0; 

0229 

85AF C8; 

0230 

85B0 F841; 

0231 SHFTBR: 

85E2 52; 

0232 

85E3 E2; 

0233 

85E4 6522; 

0234 

85E6 6E; 

0235 

85B7 AF; 

0236 

85P8 0CFF015C; 

0237 

85EC 9FFBFFFE; 

0238 RDXIT: 

-G=>DF 


85C0 8F; 

0239 

85C1 CF; 

0240 

85C2 F813; 

0241 

85C4 BF; 

0242 

85C5 D5; 

0243 

8 5C6 ; 

0244 .. 


EZ TRMEXT 
DEC RF 


.NO CRC ERROR RETURN 

.DEC THE ALLOWED ERROR COUNT 


GLO RF ..ANY MORE ALLOWED? 
BNZ RDWTCK ..BR IF YES 

SEP R4,A(DERR0R) 

GHI RF;ANI #01;0RI #20;PHI RF 


..SET CRC FLA 


ER TRNEXT ..RETURN 

SEP R4,A(DERROR) 

GHI RF;XRI #FF;SHL 

SEP R5 ..RETURN 

_SUBROUTINE READ 


..PRINT ERROR 
.SET/RESET ERROR FLA 


SEX PTER 

LDI #00;PHI RF ..SET READ MODE 
LDX ..GET BYTE COUNT 

ENZ SHFTBR ..BUFFER NOT EMPTY, SHIFT BUFFER 


LDI #80; STXD 


..SET READ MODE 
..INITIALIZE BYTE COUNT FOR N 


..POINT AT UNIT-SECT # 

LDX; ADI #01; STXD ..INCR SECTOR #, POINT A 

ANI #1F ..MASK OUT UNITS BITS 
SDI #1A ..SECTOR > 26 ? 

PDF CNTOK ..NO, CHECK TRACK # 

INC PTER ..POINT AT UNIT SECT # 

LDX; ANI #C0; ADI #01; STXD ..RESET SECT # T 

LDX; ADI #01; STR PTER ..INCR TRK # 

LDX ..GET TRK # 

SDI #4C ..TRK # > 76 ? 

PDF TRKOK ..TRACK IN RANGE, OK 
INC PTER; INC PTER ..POINT BYTE COUNT 

HIT ?.«00 ..SET UP TO READ STATUS 

..PRINT TRACK RANGE ERROR 


BR TRKNG 
SEX R 2 

SEP R4,A(TRNFR1) 


..READ A SECTOR 


ERROR NOT CRC 


BNF RDXIT 
SEX PTER 

GHI RF;ANI #20;BNZ REREAD 


..READ NEXT S 


LDI #40 
LSKP 
LDI #41 
STR R2 
SEX R2 
OUT 5; 
INP 6 
PLO RF 


.EXAMINE READ BUFFER 
.SHIFT READ BUFFER 


DEC R2 
..READ 


A BYTE 
SAVE IT 


LDN PTER; SMI #01; STR PTER ..DEC BYTE COUNT 
GHI RF;XRI #FF;SHL ..SET/RESET ERROR FLA 


GLO RF 
LSDF 
LDI #13 
PHI RF 
SEP R5 


..GET READ BYTE 

..IF NO ERROR RETURN CHARACTER 
..IF ERROR RETURN DC3 

..RETURN 
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85C6 


0245 


85C6 


0246 

« * 

85C6 

9F52; 

0247 

WRITE: 

85C8 

6422; 

0248 


85CA 

F801DF; 

0249 


85CD 

E36531; 

0250 


85D0 

EC; 

0251 


85D1 

F0FC01; 

0252 


85D4 

5C; 

0253 


85D5 

. Ff80; 

0254 


85D7 

CB8609; 

0255 


85DA 

F801BF; 

0256 

REWRIT 

8 5DD, 

F80073; 

0257 


8 5F0 


0258 


8 5£0 

F0FC0173; 

0259 


.TRK# 



85E4 

FA1 F; 

0260 


85E6 

FD1 A; 

0261 


85E8 

33 F5; 

0262 


85EA 

1C; 

0263 


85EB 

F0FAC0FC0173; 

0264 


- 1, 

POINT TRK # 



85F1 

F0FC01; 

0265 


85F4 

5C; 

0266 


85F5 

FO; 

0267 

WTCNT: 

85F6 

FD4C; 

0268 


85F8 

33FE; 

0269 


85FA 

1 Cl C; 

0270 


85FC 

306B; 

0271 


85FE 

E2; 

0272 

TRK0K1; 

85FF 

D48517; 

0273 


8602 

EC; 

0274 


8603 

9FFA20CA85DA; 

0275 



.WRITE NEXT SECTOR 
8609 9FFeFFFE; 
.G=>DF 


0276 EXWT: 


SUBROUTINE WRITE 


GHI RF; STR R2 
OUT 4; DEC R2 
LDI /!(01;PHI RF' 
SEX R3; OUT 5 , 
SEX PTER 
LDX; ADI #01 
STR PTER 
SNI #80 
LBNF EXWT 
LDI #01;PHI RF 
LDI #00;STXD 


..SAVE DATA BYTE TO STACK 
..OUTPUT THE DATA 
..SET WRITE NODE 
#31 ..LOAD WRITE BUFFER 

..POINT TO BYTE COUNT 
..INC THE BYTE COUNT 

..BYTE COUNT< 128 ? 

..BR IF YES 
..SET WRITE MODE 

..ZERO THE BYTE COUNT 
..POINT AT THE SEC# 


LDX; ADI #01; STXD ..INC SEC# AND POINT 


ANI #1F ..MASK OUT UNIT NUMBER 
SDI #1A ..SECTOR > 26 ? 

BDF WTCNT ..NO, CHECK TRK # 

INC PTER ..POINT AT UNIT/SEC# 

LDX; ANI #C0; ADI #01; STXD ..RESET SECT # TO 


LDX; ADI #01 ..INC THE TRACK# 

STR PTER 

LDX .. GET THE TRK # 

SDI #4C ..TRK # > 76 ? 

BDF TRK0K1 ..TRACK IN RANGE, OK 

INC PTER;INC PTER ..POINT TO BYTE COUNT 

BR TRKN6 ..PRINT TRACK RANGE ERROR 

SEX R2 

SEP R4,A(TRNFP1) ..WRITE BUFFER TO DIS 

SEX PTER 

GHI RF;ANI #20;LBNZ REWRIT ..CRC ERROR 

GHI RF;XRI #FF;SHL ..SET/RESET ERROR FLA 


860D 

D5; 

0277 


SEP 

R5 ..RETURN 

860E 

f 

0278 




860E 

) 

0279 




860E 


0280 



.SUBROUTINE WAIT 

860E 


0281 




860E 

E2; 

0282 

WAIT: 

SEX 

R2 

860F 

6E; 

0283 


INP 

6 ..GET STATUS 

8610 

FA20; 

0284 


ANI 

#20 ..DRIVE FAIL ? 

8612 

3A19; 

0285 


PNZ 

FAILUR ..DRIVE FAILED, PRINT ERROR 

8614 

6E; 

0286 


INP 

6 ..GET STATUS 

8615 

FA40; 

0287 


ANI 

#40 ..DRIVE ACTIVE? 

8617 

3A1 F; 

0288 


BNZ 

NOFAIL ..YES, NO FAILURE 

8619 

F800AF; 

0289 

FAILUR: 

LDI 

#00;PL0 RF ..CLEAR TRY COUNT, DRIVE FAIL 

861C 

D48629; 

0290 


SEP 

R4,A(DERR0R) ..PRINT DRIVE FAILURE 

861F 

6E; 

0291 

NOFAIL: 

INP 

6 ..GET STATUS 

8620 

FA08; 

0292 


ANI 

#08 ..CRC ERROR? 

8622 

3A28; 

0293 


PNZ 

RETWAT ..IF ERROR RETURN 

8624 

6EF6; 

0294 


INP 

6;SHR ..check if operation DONE 

8626 

330E; 

0295 


BDF 

WAIT ..NOT DONE 

8628 

D5; 

0296 

RETWAT: 

SEP 

R5 ..RETURN 

8629 

} 

0297 




8629 

/ 

0298 


....SUBROUTINE DISK ERROR 

8629 

/ 

0299 




8629 

E2; 

0300 

DERROR: 

SEX 

R2 

862A 

9C738C73; 

0301 


GHI 

RC;STXD;GLO RC;STXD ..SAVE DCB POINTERS 
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862E 9F738F73; 

.R COUNT 
8632 9A738A73; 

8636 2C; 

8637 0CFA7FAA; 

.N RA.O 

863B 2C; 

863C OCBA; 

863E 9F73; 

8640 FA40; 

8642 325C; 

8644 D483F00D0A5452; 

-■;o 

^ 864B 41434E20534545; 
■ 8652 4E204552524F52; 
8659 00; 

865A 30BE; 

865C 6EFA20; 

865F 3276; 

8661 D483F00D0A4452; 
8668 49564520464149; 
866F 4C55524500; 

8674 30EE; 

8676 6EFA08; 

8679 3290; 

867E D483F00D0A4352; 
8682 43204552524F52; 

8689 00; 

868A 8AF980AA; 

868E 30EE; 

8690 6EFA40; 

8693 3AAF; 

8695 D483F00D0A4452; 

.0 

869C 495645204E4F54; 
86A3 20414354495645, 
86AA 00; 

86AB 60; 

86AC C08738; 

86AF D483F00D0A5452, 
86B6 41434E203E3736, 
86BD 00; 

86BE 60F0; 

E6C0 F6; 

86C1 33D5; 

86C3 D483F020445552 
86CA 494E4720524541 
86D1 4400; 

86D3 30E6; 

86D5 D483F020445552 
86DC 494E4720575249 
86E3 544500; 

86E6 D483F020554E49 
86ED 542000; 

86F0 8AFA40; 

.IT BIT 
86F3 CE; 

86F4 F801; 

86F6 FC30; 

86F8 EF; 

86F9 D481A4; 

86FC D483F02C205452 
8703 41434B2000; 


0302 


GHI RF;STXD GLO RF;STXD ..SAVE FLAGS AND ERRO 


0303 

0304 

0305 


GHI RA;STXD;GLO RA;STXD ..SAVE RA 
DEC RC ..POINT TO UNIT-SECT# 

LDN RC;ANI #7F;PL0 RA ..SAVE UNIT-SECTOR# I 


0306 

0307 

0308 

0309 

0310 

0311 


DEC RC ..POINT TO TRK# 

LDN RC;PHI RA ..SAVE TRACK# IN RA.1 

GHI RF;STXD ..SAVE FLAGS 

ANI #40 ..CHECK FOR SEEK ERROR 

BZ ERRIO ..NOT SEEK ERROR 

SEP R4,A(OSTRNG),#ODOA,T'TRACK SEEK ERROR',#0 


0311 

0311 

0311 

0312 

0313 ERRIO: 

0314 

0315 

0315 

0315 

0316 

0317 ERR20: 

0318 

0319 

0319 

0319 - 

0320 

0321 

0322 ERR30: 
0323 
;0324 


ER RDWRPT 

INP 6;ANI #20 ..CHECK FOR DRIVE FAILURE 

EZ ERP20 ..NOT DRIVE RFAILURE 

SEP R4,A(OSTRNG),#ODOA,T'DRIVE FAILURE',#00 


BR RDWRPT 

INP 6;ANI #08 ..CHECK FOR CRC ERROR 

EZ ERR30 ..NOT CRC ERROR 

SEP R4,A(0STRNG),#0D0A,T'CRC ERROR',#00 


GLO RA;ORI #80;PL0 RA ..SET CRC FLAG 
ER RDWRPT 

INP 6;ANI #40 ..DRIVE ACTIVE? 

BNZ ERR40 ..YES 

SEP R4,A(0STPNG),#0D0A,T'DRIVE NOT ACTIVE',#0 


;0324 

0324 

0325 

0326 

;0327 

ERR40 : 

;0327 

0327 

032P 

RDWRPT: 

0329 

0330 

;0331 

RDOP : 

;0331 
0331 
033 2 
;0333 

WROP: 

;0333 

0333 

;0334 

UTSPT: 

0334 

0335 



,IRX 

LBR DERXT ..EXIT 

SEP R4,A(OSTRNG),#ODOA,T'TRACK >76',#00 


,IRX;LDX ..GET FLAGS 

SHR ..WRITE FLAG=>DF 

BDF WROP ..PRINT "DURING WRITE" 

SEP R4,A(OSTRNG),T' DURING READ',#00 


BR UTSPT ..PRINT "UNIT TRACK SECTOR" 

SEP R4,A(OSTRNG),T' DURING WRITE',#00 

SEP R4,A(0STRNG),T' UNIT ',#00 

GLO RA;ANI #40 ..GET UNIT-SECT # AND TEST UN 


0336 

0337 

0338 

0339 

0340 

;0341 

0341 


LSZ 

LDI 

ADI 

PHI 

SEP 

SEP 


..NOT UNIT 1 

#01 

#30 

RF 

R4,A(TYPE) ..TYPE UNIT # 

R4,A(OSTRNG),T', TRACK ',#00 











Appendix G - UT20 Listing 


m 


.119 


8708 

9ABF; 

0342 


870A 

D4874D; 

0343 


870D 

D483F02C205345 

;0344 


8714 

43544F522000; 

0344 


871 A 

8AFA1FBF; 

0345 


871 E 

D4874D; 

0346 


8721 

8AFA803232; 

0347 


.LAG 

8726 

D483F020534B49 

;0348 


872D 

5050454400; 

0348 


8732 

D483F00D0A00; 

0349 

NOSKIP: 

8738 

60; 

0350 

DERXT: 

8739 

72AA72EA; 

0351 


^873 D 

72AF72; 

0352 



■‘8740 

FA01F980PF; 

0353 


8745 

72ACF0EC; 

0354 


8749 

E3650B; 

0355 


87^C 

D5; 

0356 


874D 

/ 

0357 

«■ A 

874D 

W 

0358 


874D 

/ 

0359 

. . 

874D 

9F; 

0360 

TYPBCD: 

874E 

FAFO; 

0361 


8750 

F6F6F6F6; 

0362 


8754 

AF; 

0363 


8755 

9FFA0FBF; 

0364 


8759 

FFOA; 

0365 


875B 

3 861 ; 

0366 


875D 

9FFC06BF; 

0367 


8761 

8F; 

0368 

SIXLP: 

.HEX 

8762 

COUNT 

3 27 5; 

0369 


8764 

2F; 

0370 


8765 

9FFC16BF; 

0371 


8769 

FAOF; 

0372 


876e 

FFOA; 

0373 


876D 

3B61 ; 

0374 


876F 

9FFC06EF; 

0375 


8773 

3061 ; 

0376 


8775 

D481AE; 

0377 

EXITBC : 

8778 

D5; 

0378 


8779 

/ 

0379 


8779 

8C73; 

0380 

NOTRAM: 

877B 

9C73; 

0381 


877D 

D483F00D0A5241; 

0382 


8784 

4D2041542000; 

0382 


878A 

98BF; 

0383 


878C 

D481AE; 

0384 


878 F 

88BF; 

0385 


8791 

D481AE; 

0386 


8794 

D483F0203F00; 

0387 


879A 

12; 

0388 


879P 

42BC; 

0389 


879D 

02AC; 

0390 


879F 

D5; 

0391 


87A0 

r 

0392 


87A0 

9 

0393 

..THIS R 


GHI RA; PHI RF ..GET TRACK U 

SEP R4,A(TYPBCD) ..TYPE TRACK « 

SEP R4,A (OSTRNG),T', SECTOR \#00 

GLO RA;AMI /K'1F;PHI RF ..GET SECTOR ti 
SEP R4,A(TYPBCD) ..TYPE SECTOR « 

GLO RA;ANI #80;PZ NOSKIP ..CHECK CRC F 

SEP R4,A(0STRNG),T' SKIPPED’,#00 

SEP R4,A (OSTRNG),#ODOAOO ..TYPE CR-LF 

,IRX ..RECOVER REGISTERS FROIY STACK 

LDXA;PLO RA;LDXA;PHI RA ..GET OLD RA 


LDXA;PLO RF;LDXA 


..GET FLAGS AND ERROR CO 


ANI #01;0RI #80;PHI RF ..SET ERROR FLAG 
LDXA;PLO RC;LDX;PHI RC ..GET DCB POINTER 
SEX R3;0UT 5,#0F ..CLEAR ERROR FLAGS 

SEP R5 ..RETURN 


.SUBROUTINE TO PRINT HEX IN RF.1 AS BCD ft 




.TS OF RF.1. 

87A0 ; 0394 

.ARRIAGE RETURNS 

87A0 ; 0395 


GHI RF ..GET INPUT 

ANI #F0 ..STORE AS ? HEX DIGITS 

SHR;SHR;SHR;SHR 

PLC RF 

GHI RF;ANI #OF;PHI RF 

SNI 10 ..DECIMAL ADJUST LOW DIGIT 

ENF SIXLP 

GHI RF;ADI 6; PHI RF 

GLO RF ..ADD 16 TO BCD NUMBER FOR EACH HIGH 

BZ EXITBC ..IF HIGH C0UNT=0, EXIT 

DEC RF 

GHI RF;ADI #16;PHI RF 
ANI #0F 

SMI 10 ..DECIMAL ADJUST BCD RESULT 
BNF SIXLP 

GHI RF;ADI 6;PHI RF 

BR SIXLP ..LOOP UNTIL DONE 

SEP R4,A(TYPE?) 

SEP R5 ..RETURN 


GHI RC;STXD 

SEP R4,A (OSTRNG),#ODOA,T'RAM AT ',#00 

GHI R8;PHI RF 
SEP R4,A(TYPE2) 

GLO R8;PHI RF 
SEP R4,A(TYPE2) 

SEP R4,A (OSTRNG),!' ?',#00 
INC R2 

LDA R2;PHI RC 
LDN R2;PL0 RC 
SEP R5 


..IT SUPRESSES PRINTING OF LINE FEEDS, AND REPLACES C 
..WITH A CR-LF PAIR. 


* 
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) 


87A0 ; 

.BUT IF THE 
87A0 ; 

. WILL BE RESET 
87A0 ; 

87A0 ; 

87A0 ; 

87A0 9FFB0A; 
87A3 32PC; 

87A5 9FFE13; 
87A8 32C0; 

87AA 9FFBFF52; 
87AE 34AE; 

,87E0 6622; 

87B2 9FFE0D; 
87B5 3ABC; 

87E7 F80ABF; 
87BA 30AA; 

87EC F801F6; 
87BF D5; 

87C0 F6; 

87C1 D5; 

87C2 ; 

0000 


0396 ..NORMALLY, THIS ROUTINE RETURNS WITH THE DFLAG SET, 

0397 ..CHARACTER IN RF.1 WAS A DC3(END OF FILE), THE DFLAG 

0398 ..ON RETURN. 

0399 .. 

0400 .. 

0401 PRNTRF: GHI PF;XRI #0A ..IF LINE FEED, EXIT 

0402 EZ EXITDF 

0403 GHI RF;XRI #13 ..IF DC3, EXIT 

0404 EZ EXITEF 

0405 PRINT1: GHI RF;XRI #FF;STR R2 ..INVERT DATA 

. .WAIT UNTIL READY 
..OUTPUT CHARACTER 
..CARRIAGE RETURN? 

..NO, EXIT 

..YES, PRINT A LINE FEED 

..SET DFLAG 
..AND RETURN 
..RESET DFLAG 
..AND RETURN 


0406 El * 

0407 OUT 6; DEC R2 

0408 GHI RF;XRI #0D 

0409 ENZ EXITDF 

0410 LDI #0A;PHI RF 

0411 BR PRINT1 

0412 EXITDF: LDI #01;SHR 

0413 SEP R5 

0414 EXITEF: SHR 
0415 SEP R5 
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Appendix H - 

System Checkout Game - DEDUCE 


For checking out the CDS and to help the user 
familiarize himself with its operation, a game 
program is provided on Utility Program IJT20. The 
object of the game, called “Deduce”, is to guess a 
four-digit number (all digits different selected by the 
CDS at random and stored in its memory* The player 
should try to guess the number in a minimum number 
gf tries. He is allowed fifteen tries. After each guess, 
^CDS tells how many of the four digits are correctly 
/placed and how many are in the set but incorrectly 
placed. 

The paper tape version provides two options. 
Version A exercises the deductive skills of the player. 
Version B exercises both his deductive skills and 
memory by always erasing the previously printed 
guess. 

How to Play Deduce (Paper Tape Program) 

1. Enter the program from the paper tape provided 
into memory as described in the first Section of this 
Manual. 

2. Type $U1 to start the program. CDS gives the 
prompt message: 

VERSION AorB = > 

3. Player types either A or B (as he chooses). 

4. a. If player chooses A, CDS responds by prin¬ 
ting: 

TURN XX 
GUESS = >, 

b. If player decides upon Version B, CDS prints: 
TIME = , 

to which the player should respond with any number 
between 1 and 9 (time parameter). Afterwards, game 
continues as in step 4a: 

TURN XX 
GUESS=> 

5. At this point the player types in his guess 
number: 

xxxx 

(Numbers are assumed to be different, however, it 
may be good strategy to make some, or all, equal; 
player should remember his is given up to 15 trials.) 

Immediately after this, CDS tells him how many 
digits are correctly placed, and also how many belong 
to the set but are incorrectly placed: 

RP=X (right place) 

WP=X (wrong place) 

If his guess is entirely correct, CDS types: 

WIN= >XXXX (correct answer) 


If his guess has reached the last of his possible 
trials, the CDS answer is: 

LOSE = >XXXX (correct answer) 

In both cases return is made to a new game. 

6. a. If none of the above (WIN-LOSE) occurs, and 
player had chosen Version A, then CDS prints: 

TURN XX 
GUESS=> 

and game continues as in step # 5, or 

b. For player using Version B, CDS waits for a 
period of ~ 2X (time parameter) seconds before 
overwriting the guess just entered so as to make it 
unreadable. 

After that it writes: 

TURN XX 
GUESS=> 

and game continues as in step #5. 

Re-start Game 

A new game can be started at any time by typing in 
R instead of a digit at guessing time. CDS responds 
by printing: 

LOSE= >XXXX correct answer) 

VERSION A or B= > (new game) 

How to Play Deduce (Magnetic Tape Program) 

1. Enter the program from the magnetic tape 
provided into memory as described in the first Section 
of this Manual. 

2. Type $U1 to start the program. CDS will prompt: 
CRT? 

to which the player should respond by typing 
“N”. 

This will tell the program that a CRT is not being 
used for display. 

3. Next CDS will display the following self- 
explanatory message: 

“This RCA Microprocessor is programmed to 
play a number guessing game. Your objective is to 
guess the four different hidden digits. The COSMAC 
will tell how many digits are in the proper place, and 
how many are misplaced. To play enter your guess. ” 

TURN GUESS PROPER PLACE MISPLACED WRONG DIGITS 
15 - 

4. Now the player can enter his four-digit guess which 











Operator Manual for the RCA CDS II CDP18S005 


122 


will be automatically displayed under the heading: 
GUESS. 

Immediately CDS will respond by filling in the values 
of the columns corresponding to: 

PROPER PLACE, MISPLACED, and WRONG DIGITS 

If the guess is entirely correct the words YOU 
WIN! are displayed. If the player has reached the 
last of his 15 possible trials, the message YOU LOSE! 
is displayed along with the correct answer. 


5. If neither of the above occurs (WIN/LOSE), the 
turn number is decremented by one, and the player 
can enter a new guess. 

6. If the player is very anxious to know the right 
guess, he can Resign the game by typing R, in lieu of 
any of his guess digits. Again, in addition to the 
correct answer he will see the words: YOU LOSE! 

7. In either case of winning or losing, a new game can 
be started by hitting CR. 
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Appendix I - 

Conversion to Different Operating Voitages 


The CDS as supplied is wired for 115-volt ac 
operation. Other voltages including 100, 220, 230, or 
240 volts can be accomodated by a simple one-wire 


change on the back of the CDS. Locate the terminal 
block adjacent to the power supply. Move the top 
wire to one of the other tapes as required. The bottom 
three wires should not be moved. 





0 


240V 


0 

240V 

230 V 


0 

230V 

220 V 


'-0 

220 V 

IISV 


0 

N5V 

lOOV 


0 

toov 

NEUT 



NEUT 

3 



3 

4 


0 

4 


WIRED FOR II5-V WIRED FOR 220-V 
OPERATION AS SUPPLIED OPERATION 


92CS-296IO 


Fig. II — Conversion for different operating voltages. 


Appendix J - Connection List for Terminal Interface Cables 


PI 

8 

7 

3 

4 
10 
2 


TELETYPE TERMINAL 
P2 Signal 

Data from TTY (Current Source) 


6 

8 

7 

5 

15 

13 


Data to TTY (Current Source) 
Data to TTY (Current Return) 
Data from TTY (Current Return) 

+Vdd 

Paper Tape Control 


EIARS232C TERMINAL 
PI P2 

1 1 Ground 

2 2 Data to CDS 

3 3 Data to Terminal 

10 7 Signal Ground 

6 6 and 5 DSR 

7 8 DCD 


Held high by CDS 



















